API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ISHELL_CREATEDIALOG()

Brew Release
Brew MP 1.0.2
See Also
AEEEvent DialogInfo Error Codes Events IShell ISHELL_EndDialog ISHELL_GetActiveDialog IDialog IDIALOG_GetControl IDIALOG_SetFocus
Description
This function instructs the AEE shell to start a dialog associated with the input DialogInfo data structure or the dialog information in the associated resource file. This call causes the AEE shell to create an IDialog interface. The interface processes the dialog input parameters to create all associated controls and other items. The dialog is placed at the top of the active dialog stack.
During creation, execution, and termination, the IDialog interface sends a number of dialog-related AEEEvent items (such as EVT_DIALOG_INIT, EVT_DIALOG_START, and EVT_DIALOG_END) to the active applet. This allows the applet to control the initial contents of controls, manage control changes, and retrieve the contents of controls at termination. The applet can obtain pointers to the underlying dialog controls by calling IDIALOG_GetControl().
Params
pIShell
[]:
Pointer to the IShell interface object.
pszResFile
[]:
Pointer to the resource file containing the dialog information.
wID
[]:
ID of the dialog inside the resource file.
pInfo
[]:
Dialog information structure.
Interface
  • ISHELL
Prototype
  •     int ISHELL_CreateDialog
        (
        IShell * pIShell,
        const char * pszResFile,
        uint16 wID,
        DialogInfo * pInfo
        );
    
Return
  • AEE_SUCCESS: Successful. AEE_ENOMEMORY: Insufficient memory. AEE_EBADPARM: Invalid parameter. AEE_EFAILED: Unsuccessful.
Side Effect
  • None
Comments
None