GEOS SDK TechDocs
|
| 
2.7 Notification Messages
| 
2.9 Suspending and Unsuspending
These messages are used by the User Interface when working with the GEOS.INI files. You will probably never need to subclass or call these messages.
void MSG_META_SAVE_OPTIONS();
This message saves an object's options to the .INI file for an object. It is sent via the UI's active list mechanism.
Source: Unrestricted.
Destination: GenApplication object, which in turn broadcasts to everything on list of objects having options needing to be saved
Interception: Objects having options to save should intercept this. Superclass should be called in case any of the superclasses needs similar notification.
void MSG_META_SAVE_OPTIONS();
This message loads the object's setting from the .INI file.
Source: Unrestricted.
Destination: Any object.
Interception: Any object that should load its options should intercept this. Behavior is currently implemented for Generic UI objects.
void MSG_META_RESET_OPTIONS();
This message resets the object's settings from the .INI file to their initial state.
Source: Unrestricted. Sent to all objects on the GAGCNLT_SELF_LOAD_OPTIONS and GAGCNLT_STARTUP_LOAD_OPTIONS lists.
Destination: Any object.
Interception: Any object that wants to reset its options should intercept this. Behavior is currently implemented for Generic UI objects.
void MSG_META_GET_INI_CATEGORY(
char *buf);
This message returns the .INI file category of the object.
Source: Unrestricted, though generally self.
Destination: Object having options.
Interception: Default handler walks up tree, eventually finding name of application. Can be intercepted at any level to change the category for a branch.
Parameters: buf The buffer for .INI category string. This buffer size cannot store more than 64 bytes.
Return: Nothing returned explicitly.
GEOS SDK TechDocs
|
| 2.7 Notification Messages
| 2.9 Suspending and Unsuspending