OALSuspendHandler Class Reference
| Inherits from | NSObject |
| Declared in | OALSuspendHandler.h |
Overview
Provides two controls (interrupted and manuallySuspended) for suspending a slave object, and also propagates such control messages to interested listeners.
“interrupted” is meant to be set by the system when an interrupt occurs.
“manuallySuspended” is a user-settable control for suspending an object.
“manuallySuspended” also has an extra step in its processing: When set,
the handler makes a note of what its listeners' “manuallySuspended” values are.
When cleared, it will only clear a listener’s “manuallySuspended” value if it
was not set at suspend time. This allows for ad-hoc setting/clearing of
“manuallySuspended” in the middle of a handler/listener graph rather than
only from the top level.
When either control is set, the slave object will be suspended. When both are
cleared, the slave object will be unsuspended.
Tasks
-
+ handlerWithTarget:selector:Create a new handler with the specified slave target and selector.
-
– initWithTarget:selector:Initialize a handler with the specified slave target and selector.
-
manuallySuspendedIf YES, the manual suspend control is set.
property -
interruptedIf YES, the interrupt control is set.
property -
suspendedIf YES, the slave object is suspended.
property -
– addSuspendListener:Add a listener that will receive manual suspend and interrupt events.
-
– removeSuspendListener:Remove a registered listener.
Properties
interrupted
If YES, the interrupt control is set.
@property (readwrite, assign) bool interruptedDeclared In
OALSuspendHandler.hClass Methods
handlerWithTarget:selector:
Create a new handler with the specified slave target and selector.
+ (OALSuspendHandler *)handlerWithTarget:(id)target selector:(SEL)selectorParameters
- target
The slave object that will receive suspend/unsuspend events.
- selector
The selector for a “set suspended” method, taking a single boolean parameter.
Discussion
The selector provided must take a single boolean value like so:
– (void) setSuspended:(bool) value
Declared In
OALSuspendHandler.hInstance Methods
addSuspendListener:
Add a listener that will receive manual suspend and interrupt events.
- (void)addSuspendListener:(id<OALSuspendListener>)listenerParameters
- listener
The listener to register with this handler.
Declared In
OALSuspendHandler.hinitWithTarget:selector:
Initialize a handler with the specified slave target and selector.
- (id)initWithTarget:(id)target selector:(SEL)selectorParameters
- target
The slave object that will receive suspend/unsuspend events.
- selector
The selector for a “set suspended” method, taking a single boolean parameter.
Discussion
The selector provided must take a single boolean value like so:
– (void) setSuspended:(bool) value
Declared In
OALSuspendHandler.h