Config Library: 4.8 Object Class Reference: PrefInteractionClass

If you have any Preferences objects which write out their values to the .INI file, and if you would normally have those objects appear under a GenInteraction, then you should have them appear under a PrefInteraction instead.

Objects of the class will forward the following messages on to their children:

MSG_PREF_INIT , MSG_PREF_SET_ORIGINAL_STATE: Object will send these messages to every child that is a subclass of PrefClass .
MSG_META_LOAD_OPTIONS: Object will send this to each child that satisfies the appropriate criteria (based on the child's PA_LOAD_IF_USABLE flag).
MSG_META_SAVE_OPTIONS: Object will send this to each child that satisfies the appropriate criteria (based on the child's PA_SAVE_IF_CHANGED, PA_SAVE_IF_ENABLED, and PA_SAVE_IF_USABLE flags).
MSG_PREF_HAS_STATE_CHANGED , MSG_PREF_GET_REBOOT_INFO: Propagates these messages to children, returning the value from the first child that returns a non-null response.

Code Display 22-9 PrefInteractionClass Instance Data

@class PrefInteractionClass, PrefClass;

@instance PrefInteractionAttrs  PII_attrs = 0;

typedef ByteFlags  PrefInteractionAttrs;

#define  PIA_LOAD_OPTIONS_ON_INITIATE 0x80
/* If set, then the dialog will send MSG_PREF_INIT, 
 * followed by MSG_META_LOAD_OPTIONS to itself when it 
 * receives a MSG_GEN_INTERACTION_INITIATE */

#define PIA_SAVE_OPTIONS_ON_APPLY 0x40
/* This flag is normally OFF to allow non-dialog prefInteractions to reside inside
 * other interactions without duplicate SAVE_OPTIONS messages being sent. */

GEOS SDK TechDocs |

4.7 TitledGlyphClass | Next:

4.9 PrefDialogClass