DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Boîtes de dialogue
  • Caractéristiques de la boîte de dialogue
  • Saut de ligne dans la boîte de dialogue
  • Divers
  • Pilotage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Affiche un message dans une boîte de dialogue standard proposant les réponses "OK" et "Annuler" et renvoie la réponse de l'utilisateur.
Dialogue OK / Annuler
Remarques :
  • Cette boîte de dialogue est bloquante. Pour continuer l'exécution de l'application, l'utilisateur doit valider un des boutons.
    WINDEV Pour ne pas bloquer l'application, utilisez la fonction OKAnnulerAsynchrone.
  • WINDEV WINDEV permet d'appliquer le gabarit de votre projet à cette boîte de dialogue. Pour plus de détails, consultez Personnaliser les boîtes de dialogue.
Exemple
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU) 
// Suppression d'une ligne avec confirmation (oui par défaut)
SI OKAnnuler("Supprimer cet enregistrement ?") ALORS
	HSupprime(CLIENT)
FIN
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU) 
// Choix pour la sortie du programme
SI OKAnnuler("Voulez-vous quitter le programme?") = Oui ALORS
	Ferme()
FIN
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU) 
// 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
SI OKAnnuler(Non, "Supprimer le fichier ?") ALORS
	fSupprime(NOM_FIC)
FIN
Syntaxe
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Afficher une boîte de dialogue OK / Annuler Masquer les détails

<Résultat> = OKAnnuler([<Bouton sélectionné>, ] <Texte> [, <Ligne 2> [... [, <Ligne N>]]])
<Résultat> : Booléen
Identifie le bouton sélectionné par l'utilisateur :
FauxL'utilisateur a choisi le bouton "Annuler".
VraiL'utilisateur a choisi le bouton "OK".
<Bouton sélectionné> : Booléen optionnel
Bouton sélectionné par défaut dans la boîte de dialogue :
NonBouton "Annuler" sélectionné par défaut.
Vrai
(par défaut)		Bouton "OK" sélectionné par défaut.
<Texte> : Chaîne de caractères
Texte à afficher.
<Ligne 2> : Chaîne de caractères optionnelle
Texte affiché sur les lignes suivantes.
<Ligne N> : Chaîne de caractères optionnelle
Texte affiché sur les lignes suivantes.
Remarques

Caractéristiques de la boîte de dialogue

  • Le titre de la boîte de dialogue correspond au titre de la fenêtre (ou page) en cours.
  • Pour modifier ou définir le titre de la boîte de dialogue, utilisez la fonction TitreSuivant.
  • Le message est cadré à gauche.
  • Les libellés des boutons dépendent de la langue d'exécution de Windows.
  • Le nombre maximum de caractères affichés est limité à 4096. Si une chaîne plus grande est passée en paramètre, elle sera tronquée.
  • L'icône affichée (point d'exclamation) ne peut pas être modifiée.
WINDEV Pour personnaliser cette boîte de dialogue (ainsi que toutes les boîtes de dialogue système de votre application), cochez l'option "Personnaliser les fenêtres système (Info, OuiNon, Confirmer, Dialogue)" dans l'onglet "Style" de la description du projet. Pour plus de détails, consultez Personnaliser les boîtes de dialogue.

Saut de ligne dans la boîte de dialogue

La chaîne prédéfinie RC (Retour Chariot) peut être utilisée pour forcer le passage à la ligne suivante. Par exemple : 
SI OKAnnuler("Attention : vous allez supprimer cet enregistrement" + RC + ...
	"Voulez-vous continuer ?") ALORS
	HSupprime(CLIENT)
FIN
est équivalent à : 
SI OKAnnuler("Attention : vous allez supprimer cet enregistrement", ...
	"Voulez-vous continuer ?") ALORS
	HSupprime(CLIENT)
FIN
Il est également possible d'utiliser la syntaxe des chaînes multilignes. Par exemple : 
OKAnnuler(
[
Attention : vous allez supprimer cet enregistrement.

Voulez-vous continuer ?
])
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Divers

  • Les timers (fonction TimerSys) ne sont pas stoppés lors de l'appel de cette fonction.
  • WINDEV Les événements Windows ne sont pas stoppés lors de l'appel à cette fonction.
  • WINDEVJava La fonction DélaiAvantFermeture limite le temps d'affichage du message. La boîte de dialogue est automatiquement fermée. Pour les boîtes de question ou de confirmation, la réponse attendue correspond au bouton par défaut.
  • Le libellé des boutons s'affiche dans la langue utilisée par Windows sur le poste en cours.
WINDEV

Pilotage

Il est possible de piloter un message OkAnnuler à l'aide de la fonction PiloteOkAnnuler.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 01/07/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale