|
|
|
|
|
- Overview
- Simple dialog boxes
- Advanced dialog boxes
- Customize dialog boxes
- Programming dialog boxes
- Asynchronous dialog
Interacting with the user
The dialog boxes are standard windows that allow you to communicate with the user. They can be used to notify an error, to ask for confirmation, ... The dialog boxes always contain the same elements: - An icon used to quickly identify the type of message displayed (information, Question or Error).
- A title displayed in the title bar.
- One or more buttons allowing the user to choose an answer. The number and the type of these buttons depend on the type of dialog box used.
- A text on one or more lines corresponding to the message intended for the user.
There are different dialog boxes: - Simple dialog boxes
These dialog boxes contain an image, text and one or more OK, Cancel, Yes or No buttons. - Advanced dialog boxes.
These dialog boxes can display specific text in the buttons or allow user input.
It is possible to: Several types of dialog boxes are available: - Information or error dialog boxes. For example:
- Question dialog boxes. For example:
- Confirmation dialog boxes. For example:
Remarks: - The button that will be selected by default can be defined for each type of dialog box.
- The text of the buttons is displayed in the system language.
- Some functions may not be available depending on the platform used.
Dialog boxes can: - use the system style.
- include AAFs (Automatic Application Features). For example, the user will be able to associate a keyboard shortcut with each button, or to set the automatic execution of a button.
Note: From version 28 U1 onwards (version 280075), this feature is available by default for new projects. - be fully customized. This allows you to automatically apply the skin template of the current application or to use multilingual dialog boxes.
The following functions are used to handle dialog boxes:
| | Confirm | Displays a message in a standard dialog box that proposes "Yes", "No", "Cancel" and returns the user's choice. | Dialog | Displays a message box and returns the value of the button clicked by the user. | Error | Displays a custom error message in a system error window. | Info | Displays a custom message in a system information window. | Input | Displays a message allowing the user to type an information. | OKCancel | Displays a message in a standard dialog box that proposes "OK" and "Cancel" and returns the user's choice. | Warning | Displays a custom message in a system warning window. | YesNo | Displays a message in a standard dialog box that proposes "Yes" and "No" and returns the user's choice. |
By default, dialog boxes are modal. To make dialog boxes modeless, you can: - automatically close these dialog boxes. By default, dialog boxes are closed only when the user clicks one of their buttons. If no button is pressed, the application is blocked.
To avoid blocking the application, use DelayBeforeClosing and specify the amount of time after which the dialog box is automatically closed. - use ErrorWithTimeout and InfoWithTimeout to display information or error messages without blocking the application.
- use asynchronous dialog functions.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|