Ets_Dbox_Load()
Note: Requires OPNET Development Kit
Abstract
Load a dialog box from the resource file.
Syntax
Ets_Dbox_Load (parent_dbox_ptr, dialog_resource_path, client_state_ptr)
| Argument | Type | Description |
|---|---|---|
parent_dbox_ptr |
EtsT_Dbox * |
a parent dialog reference which can be nil |
dialog_resource |
const char * |
path to the dialog resource inside a resource file. For example, a dialog resource called my_dialog, located inside a dictionary my_dictionary has the path my_dictionary/my_dialog |
client_state_ptr |
void * |
arbitrary client state to be associated with a dialog |
Return Type
EtsT_Dbox *
a pointer to the newly created dialog box, or OPC_NIL if an error occurred
Header
ets_api_gui.h
Details
Loads a dialog box, including all controls defined in that dialog, from one of the resource files associated with the application. Resource files (.wrc) can be created and modified with the op_etsed utility and can be attached to the application via the "program_resources" option in the top level product configuration script (such as odktools.ets)
This function can be used to efficiently create a dialog box with pre-defined structure and contents.