PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Characteristics of dialog box
  • Line break in the dialog box
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Displays a message in a standard dialog box that proposes "Yes", "No", "Cancel" and returns the user's choice.
Confirmation example
Remarks:
  • This is a modal warning window. To continue running the application, the user must validate one of the buttons.
Example
Reports and Queries
Res is int
NextTitle("Modifying the form")
Res = Confirm("Some modifications have been made to the form.", ...
"Do you want to save them before you close the form?")
SWITCH Res
CASE Yes: SaveForm() // Backup process
CASE No: Close()
CASE Cancel: SetFocusAndReturnToUserInput()
END
Syntax
Reports and QueriesWindows

Displaying a Confirm dialog box Hide the details

<Result> = Confirm([<Selected button>, ] <Text> [, <Line 2> [... [, <Line n>]]])
<Result>: Integer constant
Identifies the button selected by the user:
No0The user selected [NO].
Yes1The user selected [YES].
Cancel2The user selected [CANCEL].
<Selected button>: Optional integer constant
Button selected by default in the dialog box:
No0selected by default.
Yes
(Default value)
1selected by default.
Cancel2selected by default.
<Text>: Character string
Text to display.
<Line 2>: Optional character string
Text displayed on the second line.
<Line n>: Optional character string
Text displayed on the Nth line.
Remarks

Characteristics of dialog box

  • The message is aligned to left.
  • The captions of buttons depend on runtime language of Windows (or on the runtime language of browser for a WEBDEV site).
  • The maximum number of characters cannot exceed 4096. If a larger string is passed in parameter, it will be truncated.
  • The icon displayed (exclamation mark in a WINDEV application, question mark in a WEBDEV application) cannot be modified.
  • The title of the dialog box corresponds to the title of the current window (or page).
  • To modify or define the title of dialog box, use NextTitle.

Line break in the dialog box

The CR string (Carriage Return) can be used to force a break to the next line. For example:
Confirm("The XXX form was modified." + CR + ...
"Do you want to save it before exiting?")
is equivalent to:
Confirm("The XXX form was modified.", ...
"Do you want to save it before exiting?")
You also have the ability to use the syntax of multiline strings. For example:
Confirm(
[
The XXX form has been modified.
 
DO you want TO save changes before closing?
])

Miscellaneous

  • Timers (TimerSys) are not stopped when this function is called.
  • The text of the buttons is displayed in the system language.
Component: wd270obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment