ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Dialog Box functions
  • Features of the 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

Features of the dialog box

  • The message is aligned to the left.
  • The text of the buttons changes according to the language used by Windows at runtime (or used by the browser, in the case of a WEBDEV website).
  • The maximum number of characters cannot exceed 4096. If a larger string is passed as 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: wd290obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Exemplo Confirm
Exemplo Confirm

Res is int
NextTitle("Modifica o Formulario")
Res = Confirm("Primeira Linha."+CR+"TESTE","Seguda Linha?")
SWITCH Res
CASE Yes:
Info("ok")
CASE No:
Close()
CASE Cancel:
ReturnToCapture()
END

//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/07/curso-windev-funcoes-dialogo-1-confirm.html
https://www.youtube.com/watch?v=jjBIYgdVK1s
De matos AMARILDO
08 Jul. 2016

Last update: 02/28/2024

Send a report | Local help