Ets_Dbox_Load_Blocking()
Note: Requires OPNET Development Kit
Abstract
Load and process a dialog box modally.
Syntax
Ets_Dbox_Load_Blocking (parent_dbox_ptr, resource_path, client_state_ptr)
| Argument | Type | Description |
|---|---|---|
parent_dbox_ptr |
EtsT_Dbox * |
a parent dialog reference which can be nil |
resource_path |
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 will have the path my_dictionary/my_dialog |
client_state_ptr |
void * |
arbitrary client state to be associated with a dialog |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if dialog was successfully loaded and processed and EtsC_Compcode_Failure otherwise.
Header
ets_api_gui.h
Details
Similarly to Ets_Dbox_Load(), loads a dialog box from the resource file. After loading, the dialog box is opened in a blocking modal mode and fully processed in a nested event loop. Blocking the modal mode prevents the user from making changes to any other application windows present at a time. By the time this function returns a result code, the created blocking dialog box is already processed, closed and destroyed.
This function is convenient for implementing "screens," or wizard-like chained user interaction interfaces.