ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Dialog Box functions
  • Features of the dialog box
  • Line break in the dialog box
  • Miscellaneous
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Displays a message in a standard dialog box that proposes "OK" and "Cancel" and returns the user's choice.
OK / Cancel dialog
Remarks:
  • This is a blocking dialog box. To continue running the application, the user must validate one of the buttons.
Example
Reports and Queries
// Suppression d'une ligne avec confirmation (oui par défaut)
IF OKCancel("Supprimer cet enregistrement ?") THEN
	HDelete(CLIENT)
END
Reports and Queries
// Choix pour la sortie du programme
IF OKCancel("Voulez-vous quitter le programme?") = Yes THEN
	Close()
END
Reports and Queries
// Demande de confirmation de la suppression du fichier dont 
// le nom est contenu dans la variable NOM_FIC, avec 
// positionnement sur le bouton "Non" de la fenêtre OKAnnuler
IF OKCancel(No, "Supprimer le fichier ?") THEN
	fDelete(NOM_FIC)
END
Syntax
Reports and Queries

Displaying an OK/Cancel dialog box Hide the details

<Result> = OKCancel([<Selected button>, ] <Text> [, <Line 2> [... [, <Line N>]]])
<Result>: Boolean
Identifies the button selected by the user:
FalseThe "Cancel" button was chosen by the user.
TrueThe "OK" button was chosen by the user.
<Selected button>: Optional boolean
Button selected by default in the dialog box:
No"Cancel" button selected by default.
True
(by default)
"OK" button selected by default.
<Text>: Character string
Text to display.
<Line 2>: Optional character string
Text displayed in the following lines.
<Line N>: Optional character string
Text displayed in the following lines.
Remarks

Features of the dialog box

  • 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.
  • The message is aligned to the left.
  • The captions of buttons depend on the runtime language of Windows.
  • 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) cannot be modified.

Line break in the dialog box

The CR string (Carriage Return) can be used to force a break to the next line. For example:
IF OKCancel("Attention : vous allez supprimer cet enregistrement" + CR + ...
	"Voulez-vous continuer ?") THEN
	HDelete(CLIENT)
END
is equivalent to:
IF OKCancel("Attention : vous allez supprimer cet enregistrement", ...
	"Voulez-vous continuer ?") THEN
	HDelete(CLIENT)
END
You also have the ability to use the syntax of multiline strings. For example:
OKCancel(
[
Attention : vous allez supprimer cet enregistrement.

Voulez-vous continuer ?
])
Reports and Queries

Miscellaneous

  • Timers (TimerSys) are not stopped when this function is called.
  • The text of the buttons is displayed in the system language.
Business / UI classification: UI Code
Component: wd300obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Exemplo OkCancel
Exemplo OkCancel

IF OKCancel("Vamos Gravar") THEN
//Comandos
Info("Comandos")
END

//Blog com Video e exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/07/curso-windev-funcoes-dialogo-2-okcancel.html
https://www.youtube.com/watch?v=ECbkPsdEoIY
De matos AMARILDO
10 Jul. 2016

Last update: 03/27/2025

Send a report | Local help