GEOS SDK TechDocs
|
| 
3.3 Interpreting Double-Clicks
| 
3.5 Setting a Trigger As the Default
MSG_GEN_TRIGGER_SEND_ACTION, MSG_GEN_ACTIVATE
In almost all cases, the specific UI initiates the action of the GenTrigger. Once the specific UI determines that a trigger is activated, it will send a
MSG_GEN_TRIGGER_SEND_ACTION
to the object, which will in turn send the message in
GTI_
actionMsg
to the object in GTI_
destination
. In some rare cases, however, you may wish to manually "trigger" the GenTrigger yourself. This can be done by sending the object the
MSG_GEN_TRIGGER_SEND_ACTION
yourself.
Note that this message, in effect, skips the specific UI and thus any specific functionality defined for activating a trigger will be ignored. In OSF/Motif, for example, a trigger may "blink" (display itself in reverse video) when activated. To perform the default specific UI behavior, send the object a
MSG_GEN_ACTIVATE
instead, which will perform the default activation for an object and then call
MSG_GEN_TRIGGER_SEND_ACTION
.
MSG_GEN_TRIGGER_SEND_ACTION
void MSG_GEN_TRIGGER_SEND_ACTION(
Boolean doublePressFlag);
This message causes a GenTrigger to send its action message specified in
GTI_actionMsg
to the output specified in GTI_
destination
if the object is GS_USABLE. This message is sent automatically by the UI as part of the default behavior when a GenTrigger is activated by the specific UI. If you wish to simulate a double-click, sending the message included in an object's ATTR_GEN_TRIGGER_CUSTOM_DOUBLE_PRESS, pass this message with a value of
true
. Double-press messages may not pass any data in a trigger's ATTR_GEN_TRIGGER_ACTION_DATA.
Slightly more useful is the
GenClass
message
MSG_GEN_ACTIVATE
, which activates the trigger at the specific UI's level, performing any default activation behavior (such as making the trigger blink to show that it is being activated).
Source: Unrestricted. Usually the specific UI.
Destination: Any usable GenTrigger object
Parameters:
doublePressFlag
Pass
true
to use the message stored in ATTR_GEN_TRIGGER_CUSTOM_DOUBLE_PRESS rather than message in GTI_
actionMsg
.
Return: Nothing.
Interception: Generally not intercepted.
See Also:
MSG_GEN_ACTIVATE
GEOS SDK TechDocs
|
| 3.3 Interpreting Double-Clicks
| 3.5 Setting a Trigger As the Default