Ets_Msg_Confirm()
Note: Requires OPNET Development Kit
Abstract
Displays a confirmation dialog box with an OK button and a message.
Syntax
Ets_Msg_Confirm (ets_dbox_ptr, header, line1, line2, line3)
| Argument | Type | Description |
|---|---|---|
ets_dbox_ptr |
EtsT_Dbox * |
pointer to the dialog box this error is related to. OPC_NIL is acceptable. |
header |
const char * |
header of confirm dialog box. OPC_NIL is acceptable. |
line1 |
const char * |
first line of message string. |
line2 |
const char * |
second line of message string. OPC_NIL is acceptable. |
line3 |
const char * |
third line of message string. OPC_NIL is acceptable. |
Return Type
void
No return value.
Header
ets_api_gui.h
Details
This function displays a dialog box with the specified message and an OK button. The user must click OK to proceed with further use of the tool. The message is also recorded in the message log. This is useful for conveying a warning message to the user.
This is the highest level of notification and must be used to inform user about critical errors only, such as errors that are not directly caused by user actions. For example, “Unable to save file because the disk is locked.”
See the other Ets_Msg… functions for lower levels of event notification.