- The different types of dialog boxes
- Types of dialog boxes
- Asynchronous dialog
- Customizing the standard dialog boxes
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.
- The title of the dialog box corresponds to the title of the current window (or page).
To comply with the system specifications, the title of dialog box is empty by default. To define this title, use NextTitle.
- To modify or define the title of dialog box, use NextTitle.
- 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.
The different types of dialog boxes
Types of dialog boxes
Several types of dialog boxes are available:
- The confirmation dialog boxes (WLanguage Confirm function).
- 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.
WINDEV and WINDEV Mobile offer several functions for managing asynchronous dialogs. These functions are identical to the standard functions. Only the word "Asynchronous" has been added to easily identify them:
|ConfirmAsynchronous||Displays a non-blocking message in a standard dialog box with the answers "Yes", "No", "Cancel" and calls a WLanguage procedure with the user's response.|
|DialogAsynchronous||Displays a non-blocking message box and calls a WLanguage procedure with the value of the button clicked by the user.|
|ErrorAsynchronous||Displays a custom error message in a non-blocking system error window.|
|ErrorWithTimeoutAsynchronous||Displays a custom error message in a non-blocking system error window for a given amount of time.|
|InfoAsynchronous||Displays a non-blocking custom message in a system information window.|
|InfoWithTimeoutAsynchronous||Displays a custom message in a non-blocking system information window for a given amount of time.|
|OKCancelAsynchronous||Displays a message in a standard non-blocking dialog box with the answers "OK" and "Cancel" and calls a WLanguage procedure with the user's response.|
|WarningAsynchronous||Displays a custom message in a non-blocking system warning window.|
|YesNoAsynchronous||Displays a message in a standard non-blocking dialog box with the answers "Yes" and "No" and calls a WLanguage procedure with the user's response.|
These functions are required to compile a Catalyst application. They can also be very useful in your Windows applications. They allow for non-blocking dialog with the user. The application can give information to the user or ask a question but the code continues to run, even if the user is not in front of the screen or if they need time to answer: the program keeps running.
Here is how it works:
- Calling the function opens the dialog box that corresponds to that function.
- The code that follows the call continues to run.
- When the user clicks one of the buttons in the dialog box, the "callback" procedure of the function is run. This procedure allows processing the user's response if necessary.
Customizing the standard dialog boxes
- customize these dialog boxes and automatically apply the skin template of the current application to them (or by using multilingual dialog boxes). For more details, see Customizing dialog boxes.
- automatically close these dialog boxes to avoid locking the application. By default, the dialog boxes are closed only when the user clicks one of their buttons. If no button is pressed, the application is locked.
To avoid any risk of lock, use DelayBeforeClosing and specify the amount of time after which the dialog box is automatically closed.
This page is also available for…