PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • The different types of dialog boxes
  • Types of dialog boxes
  • Asynchronous dialog
  • Customizing the standard dialog boxes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
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).
      AndroidiPhone/iPad 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 information or error dialog boxes (WLanguage Warning, Error and Info functions).
    Warning

    Error

    Information

    ErrorWithTimeout and InfoWithTimeout are used to display these information or error boxes without blocking the application.
  • The question dialog boxes (WLanguage YesNo and OKCancel functions).
    Yes / No

    OK / Cancel
  • The confirmation dialog boxes (WLanguage Confirm function).
    Dialog
Remarks:
  • The button that will be selected by default can be defined for each type of dialog box.
  • The caption of buttons is displayed in the language used by Windows on the current computer.
  • Some functions may not be available depending on the platform used.
Versions 25 and later
WINDEVAndroidiPhone/iPad

Asynchronous dialog

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:
Versions 25 and later
ConfirmAsynchronous
New in version 25
ConfirmAsynchronous
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.
Versions 25 and later
DialogAsynchronous
New in version 25
DialogAsynchronous
DialogAsynchronous
Displays a non-blocking message box and calls a WLanguage procedure with the value of the button clicked by the user.
Versions 25 and later
ErrorAsynchronous
New in version 25
ErrorAsynchronous
ErrorAsynchronous
Displays a custom error message in a non-blocking system error window.
Versions 25 and later
ErrorWithTimeoutAsynchronous
ErrorWithTimeoutAsynchronous
Displays a custom error message in a non-blocking system error window for a given amount of time.
Versions 25 and later
InfoAsynchronous
New in version 25
InfoAsynchronous
InfoAsynchronous
Displays a non-blocking custom message in a system information window.
Versions 25 and later
InfoWithTimeoutAsynchronous
InfoWithTimeoutAsynchronous
Displays a custom message in a non-blocking system information window for a given amount of time.
Versions 25 and later
OKCancelAsynchronous
New in version 25
OKCancelAsynchronous
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.
Versions 25 and later
WarningAsynchronous
New in version 25
WarningAsynchronous
WarningAsynchronous
Displays a custom message in a non-blocking system warning window.
Versions 25 and later
YesNoAsynchronous
New in version 25
YesNoAsynchronous
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 necessary to compile a Catalyst application but 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.
The principle is as follows:
  • 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.
New in version 25
WINDEVAndroidiPhone/iPad

Asynchronous dialog

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:
Versions 25 and later
ConfirmAsynchronous
New in version 25
ConfirmAsynchronous
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.
Versions 25 and later
DialogAsynchronous
New in version 25
DialogAsynchronous
DialogAsynchronous
Displays a non-blocking message box and calls a WLanguage procedure with the value of the button clicked by the user.
Versions 25 and later
ErrorAsynchronous
New in version 25
ErrorAsynchronous
ErrorAsynchronous
Displays a custom error message in a non-blocking system error window.
Versions 25 and later
ErrorWithTimeoutAsynchronous
ErrorWithTimeoutAsynchronous
Displays a custom error message in a non-blocking system error window for a given amount of time.
Versions 25 and later
InfoAsynchronous
New in version 25
InfoAsynchronous
InfoAsynchronous
Displays a non-blocking custom message in a system information window.
Versions 25 and later
InfoWithTimeoutAsynchronous
InfoWithTimeoutAsynchronous
Displays a custom message in a non-blocking system information window for a given amount of time.
Versions 25 and later
OKCancelAsynchronous
New in version 25
OKCancelAsynchronous
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.
Versions 25 and later
WarningAsynchronous
New in version 25
WarningAsynchronous
WarningAsynchronous
Displays a custom message in a non-blocking system warning window.
Versions 25 and later
YesNoAsynchronous
New in version 25
YesNoAsynchronous
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 necessary to compile a Catalyst application but 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.
The principle is as follows:
  • 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.
WINDEVAndroidiPhone/iPad

Asynchronous dialog

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:
Versions 25 and later
ConfirmAsynchronous
New in version 25
ConfirmAsynchronous
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.
Versions 25 and later
DialogAsynchronous
New in version 25
DialogAsynchronous
DialogAsynchronous
Displays a non-blocking message box and calls a WLanguage procedure with the value of the button clicked by the user.
Versions 25 and later
ErrorAsynchronous
New in version 25
ErrorAsynchronous
ErrorAsynchronous
Displays a custom error message in a non-blocking system error window.
Versions 25 and later
ErrorWithTimeoutAsynchronous
ErrorWithTimeoutAsynchronous
Displays a custom error message in a non-blocking system error window for a given amount of time.
Versions 25 and later
InfoAsynchronous
New in version 25
InfoAsynchronous
InfoAsynchronous
Displays a non-blocking custom message in a system information window.
Versions 25 and later
InfoWithTimeoutAsynchronous
InfoWithTimeoutAsynchronous
Displays a custom message in a non-blocking system information window for a given amount of time.
Versions 25 and later
OKCancelAsynchronous
New in version 25
OKCancelAsynchronous
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.
Versions 25 and later
WarningAsynchronous
New in version 25
WarningAsynchronous
WarningAsynchronous
Displays a custom message in a non-blocking system warning window.
Versions 25 and later
YesNoAsynchronous
New in version 25
YesNoAsynchronous
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 necessary to compile a Catalyst application but 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.
The principle is as follows:
  • 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
You can:
  • WINDEVWindowsJava 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.
  • WINDEVWindowsLinuxWindows MobileJava 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.
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment