Programming with Pop-Up Panels

Use the following functions to control pop-up panels in a user interface.

Pop-Up Panel

The following list of predefined functions shows the necessary steps for the installation of, user interaction with, and removal of the pop-up panels.

1. InstallPopup displays and activates a panel as a dialog box. You must load the panel with LoadPanel or create the panel using NewPanel. After a pop-up panel is installed, users cannot perform operations on any other panel.

2. Only the active pop-up panel can generate events (with the exception of EVENT_PANEL_MOVE, EVENT_PANEL_SIZE, and EVENT_CLOSE which can be generated by other panels). Use callback functions to process any kind of event or GetUserEvent to process only commit events. GetUserEvent returns the ID of the control that caused the event. GetUserEvent can operate in one of two ways:
   • Waiting for the user to generate an event before returning to the calling program
   • Returning immediately whether or not an event has occurred

3. RemovePopup removes either the active pop-up panel or all pop-up panels. However, RemovePopup does not unload the panel from memory.

Accessing Pop-Up Panels

Use SetSystemPopupsAttribute and GetSystemPopupsAttribute to set and obtain the values of attributes that affect all pop-up panels. Use the following functions to access the individual predefined pop-up panels and their unique attributes:

ConfirmPopup

DirSelectPopup

DirSelectPopupEx

FileSelectPopup

FileSelectPopupEx

FontSelectPopup

GenericMessagePopup

GetFilePopupDirHistory

GetKeyPressEventCharacter

GetKeyPressEventModifiers

GetKeyPressEventVirtualKey

GetPanelEventRect

KeyPressEventIsLeadByte

KeyPressEventIsTrailByte

MessagePopup

MultiFileSelectPopup

MultiFileSelectPopupEx

PromptPopup

SetFontPopupDefaults

SetKeyPressEventKey

SetPanelEventRect

WaveformGraphPopup

XGraphPopup

XYGraphPopup

YGraphPopup