Menus and Dialog Boxes: 4.2 Supplemental Usage: Dismissing Interactions

Up: GEOS SDK TechDocs | Up | Prev: 4.1 Initiating Interactions | Next: 4.3 Modality for Dialogs

You may dismiss dialogs and popups under application control by sending MSG_GEN_GUP_INTERACTION_COMMAND with the InteractionCommand IC_DISMISS to them. This will force dialogs to close even if the user has such a dialog pinned (in Specific UIs that support pinning). Dialogs may also be dismissed when the user activates reply bar response triggers with the GA_SIGNAL_INTERACTION_COMPLETE attribute set. (See the GenClass chapter.)

You may intercept MSG_GEN_GUP_INTERACTION_COMMAND to determine when a dialog is about to be dismissed. The handler for this message should check the incoming InteractionCommand to make sure it is IC_DISMISS before doing whatever work is needed. You should make sure to pass any non-IC_DISMISS InteractionCommand immediately to the superclass. The handler may or may not need to call the superclass for IC_DISMISS, depending on what behavior the handler is adding.


Up: GEOS SDK TechDocs | Up | Prev: 4.1 Initiating Interactions | Next: 4.3 Modality for Dialogs