interface IEvent in Tinman.Core.Util

The IEvent class implements the observer pattern.

interface	IEvent	extends	IDisposable
		base of	Event
			IEventGeneric

Attributes

LifecycleState

Returns the lifecycle state of this object.

property	LifecycleState { get }
type	LifecycleState
value		The lifecycle state.
inherited	ILifecycleState.LifecycleState

Methods

AcquireTry

Acquires a strong reference to this disposable object.

[OwnerReturn, ThreadSafe]
method	AcquireTry ()
type	IDisposable
returns			this if a new strong reference has been acquired, null if this object is already being disposed.
inherited	IDisposable.AcquireTry

Remarks:

The object will not be actually disposed by calls to Dispose when there is at least one strong reference left. Code that calls the AcquireTry method is responsible for calling the Dispose method accordingly.

This method is not intended to be used in performance-critical code. It should only be used to high-level resource management.

AddDelegate

Adds a new listener to this event.

[ThreadSafe]
method	AddDelegate (EventDelegate listener)
params	listener	[not-null]	The listener to add.

Remarks:

If a listener object is added more than once to an event, it will be notified only once. However, the remove method must be called once for each call to the add method in order to actually remove the listener.

AddListener

Adds a new listener to this event.

[ThreadSafe]
method	AddListener (IEventListener listener)
params	listener	[not-null]	The listener to add.

Remarks:

If a listener object is added more than once to an event, it will be notified only once. However, the remove method must be called once for each call to the add method in order to actually remove the listener.

Dispose

Releases all resources held by this object if there are no more strong references to it, decrements the reference counter by one otherwise.

[Dispose, OwnerThis, ThreadSafe]
method	Dispose ()
inherited	IDisposable.Dispose

Remarks:

The Dispose method silently returns if the object has already been disposed.

RemoveDelegate

Removes the given listener from the event.

[ThreadSafe]
method	RemoveDelegate (EventDelegate listener)
params	listener	[not-null]	The listener to remove.

RemoveListener

Removes the given listener from the event.

[ThreadSafe]
method	RemoveListener (IEventListener listener)
params	listener	[not-null]	The listener to remove.