MetaClass: 2.9 Utility Messages: Suspending and Unsuspending

Up: GEOS SDK TechDocs | Up | Prev: 2.8 Options Messages | Next: 2.10 Help Files

MSG_META_SUSPEND and MSG_META_UNSUSPEND work together to allow objects to optimize recalculation when doing a series of actions. These messages are implemented by various objects in the system (such as the text object and the grobj body). This mechanism is used by GenControlClass to optimize recalculation stemming from multiple controller outputs.

An object typically implements these messages by keeping a suspend count and a record of the calculations that were aborted because the object was suspended. When the suspend count reaches zero, the object will perform the calculations.

An object implementing this mechanism should always call its superclass since multiple class levels could be implementing this mechanism.

MSG_META_SUSPEND

void 	MSG_META_SUSPEND();

Suspend calculation in an object.

Source: Normally sent by a controller object but can be sent by anything.

Destination: Any object that implements the mechanism described above.

Interception: An object that wants to implement the mechanism described above.

Parameters: None.

Return: Nothing.

MSG_META_UNSUSPEND

void 	MSG_META_UNSUSPEND();

Unsuspend calculation in an object.

Source: Normally sent by a controller object but can be sent by anything.

Destination: Any object that implements the mechanism described above.

Interception: An object that wants to implement the mechanism described above.

Parameters: None.

Return: Nothing.


Up: GEOS SDK TechDocs | Up | Prev: 2.8 Options Messages | Next: 2.10 Help Files