OKAnnuler (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Boîtes de dialogue

Caractéristiques de la boîte de dialogue
Affichage de la boîte de dialogue
Saut de ligne dans la boîte de dialogue
Divers
Pilotage
Application en arrière-plan : Spécificité à partir de Android 10

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

OKAnnuler (Fonction)

En anglais : OKCancel

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.

Remarques :

Cette boîte de dialogue est bloquante. Pour continuer l'exécution de l'application, l'utilisateur doit valider un des boutons.
Pour ne pas bloquer l'application, utilisez la fonction OKAnnulerAsynchrone.
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

// Suppression d'une ligne avec confirmation (oui par défaut)
SI OKAnnuler("Supprimer cet enregistrement ?") ALORS
	HSupprime(CLIENT)
FIN

// Choix pour la sortie du programme
SI OKAnnuler("Voulez-vous quitter le programme?") = Oui ALORS
	Ferme()
FIN

// 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

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 :
Faux L'utilisateur a choisi le bouton "Annuler".
Vrai L'utilisateur a choisi le bouton "OK".

<Bouton sélectionné> : Booléen optionnel

Bouton sélectionné par défaut dans la boîte de dialogue :
Non Bouton "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.

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

OKAnnuler([<Bouton sélectionné>, ] <Code pour OK> , <Code pour Annuler> , <Texte> [, <Ligne 2> [... [, <Ligne N>]]])

<Bouton sélectionné> : Booléen optionnel

Bouton sélectionné par défaut dans la boîte de dialogue :
Non Bouton "Annuler" sélectionné par défaut.
Vrai
(par défaut) Bouton "OK" sélectionné par défaut.

<Code pour OK> : Chaîne de caractères

Code à exécuter si l'internaute choisi le bouton OK. Ce paramètre peut correspondre :
au nom d'un bouton. Si le bouton OK est sélectionné, le code de clic de ce bouton sera exécuté.
au nom d'une fonction / procédure navigateur. Si le bouton OK est sélectionné, cette procédure sera exécutée.
une chaîne ou une autre valeur. Si le bouton OK est sélectionné, la valeur sera exécutée comme étant un code JavaScript.

<Code pour Annuler> : Chaîne de caractères

Code à exécuter si l'internaute choisi le bouton Annuler. Ce paramètre peut correspondre :
au nom d'un bouton. Si le bouton Annuler est sélectionné, le code de clic de ce bouton sera exécuté.
au nom d'une fonction / procédure navigateur. Si le bouton Annuler est sélectionné, cette procédure sera exécutée.
une chaîne ou une autre valeur. Si le bouton Annuler est sélectionné, la valeur sera exécutée comme étant un code JavaScript.

<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 respecter les spécifications du système, le titre de la boîte de dialogue est vide par défaut. Pour définir ce titre, utilisez la fonction TitreSuivant.
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.

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.

Pour personnaliser cette boîte de dialogue (ainsi que toutes les boîtes de dialogue système de votre site), cochez l'option "Appliquer l'ambiance sur les boîtes de dialogue (OuiNon et OKAnnuler)" dans l'onglet "Ambiance" de la fenêtre de description du projet.

Affichage de la boîte de dialogue

L'affichage de la boîte de dialogue n'est pas bloquant. La boîte de dialogue est affichée au centre de la page, avec un effet de GFI (Grisage des Fenêtres Inaccessibles).

La fonction OKAnnuler utilise la page interne nommée "WEBDEVOKAnnuler". Pour intégrer cette page dans votre projet :

Cliquez sur parmi les boutons d'accès rapide.
La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Page" puis sur "Page".
Cliquez sur "Page interne" dans l'assistant et sélectionnez la page interne "OK / Annuler".
Validez. La page "WEBDEVOKAnnuler" est affichée sous l'éditeur.
Enregistrez la page en conservant son nom par défaut.

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 ?
])

Divers

Les timers (fonction TimerSys) ne sont pas stoppés lors de l'appel de cette fonction.
Les événements Windows ne sont pas stoppés lors de l'appel à cette fonction.
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.
Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation lors d'une connexion à une session prélancée".
Cette fonction ne doit pas être utilisée :
- dans l'événement "Modification de la taille" des fenêtres. Dans le cas contraire, l'application sera bloquée.
- dans l'événement "Changement d'orientation" des fenêtres.
- dans l'événement "Mise au premier-plan" associé au projet.
  Remarque : La fonction peut par contre être utilisée dans l'événement "Mise au premier plan" d'une fenêtre.
- dans un thread.

Pilotage

Il est possible de piloter un message OkAnnuler à l'aide de la fonction PiloteOkAnnuler.

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.

La fonction OKAnnuler peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.

Conseils :

Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.

Pour plus de détails, consultez Android 10 : Comportement des applications en arrière-plan.

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