Displays a message window, also known as a dialog box, which presents a message to the user. It is a modal window, blocking other actions in the application until the user closes it. A message_box can contain text, buttons, and symbols that inform and instruct the user.
- Examples
- The following code example demonstrates the use of message_box dialog.
|
xtd_forms_dialog_result | xtd_forms_message_box_show (xtd_forms_control *owner, const char *text, const char *caption, xtd_forms_message_box_buttons buttons, xtd_forms_message_box_icon icon, xtd_forms_message_box_default_button default_button, xtd_forms_message_box_options options, bool display_help_button) |
| Displays a message box in front of the specified window with the specified text, caption, buttons, icon, default button, options, and Help button. More...
|
|
◆ xtd_forms_message_box_show()
xtd_forms_dialog_result xtd_forms_message_box_show |
( |
xtd_forms_control * |
owner, |
|
|
const char * |
text, |
|
|
const char * |
caption, |
|
|
xtd_forms_message_box_buttons |
buttons, |
|
|
xtd_forms_message_box_icon |
icon, |
|
|
xtd_forms_message_box_default_button |
default_button, |
|
|
xtd_forms_message_box_options |
options, |
|
|
bool |
display_help_button |
|
) |
| |
Displays a message box in front of the specified window with the specified text, caption, buttons, icon, default button, options, and Help button.
- Parameters
-
owner | An xtd_forms_control that will own the modal dialog box. |
text | The text to display in the message box. |
caption | The text to display in the title bar of the message box. |
buttons | One of the xtd_forms_message_box_buttons values that specifies which buttons to display in the message box. |
icon | One of the xtd_forms_message_box_icon values that specifies which icon to display in the message box. |
default_button | One of the xtd_forms_message_box_default_button values that specifies the default button for the message box. |
options | One of the xtd_forms_message_box_options values that specifies which display and association options will be used for the message box. You may pass in 0 if you wish to use the defaults. |
display_help_button | true to show the Help button; otherwise, false. The default is false. |
- Returns
- One of the xtd_forms_dialog_result values.
- Library
- xtd_c.forms