DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV 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
  • 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
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 "Oui" et "Non" et renvoie la réponse de l'utilisateur.
Dialogue Oui / Non
Remarques :
  • Cette boîte de dialogue est bloquante. Pour continuer l'exécution de l'application, l'utilisateur doit valider un des boutons.
    WINDEVAndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction OuiNonAsynchrone.
  • 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
WINDEVEtats et RequêtesUniversal Windows 10 AppAndroidiPhone/iPadJavaCode Utilisateur (MCU)
// Choix sortie
SI OuiNon("Voulez-vous quitter le programme?") = Oui ALORS 
	Ferme()
FIN
WEBDEV - Code Navigateur
// Prérequis : Il faut avoir créé la page interne WebDevOuiNon
OuiNon(Oui,CodePourOui, CodePourNon, "Question ?")
// Procédure pour Oui
PROCÉDURE CodePourOui()
Trace("Vous avez cliqué sur Oui")
RENVOYER Vrai
// Procédure pour Non
PROCÉDURE CodePourNon()
Trace("Vous avez cliqué sur Non")
RENVOYER Vrai
Syntaxe
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppAndroidiPhone/iPadJavaCode Utilisateur (MCU)

Afficher une boîte de dialogue Oui / Non Masquer les détails

<Résultat> = OuiNon([<Bouton sélectionné>, ] <Texte> [, <Ligne 2> [... [, <Ligne N>]]])
<Résultat> : Constante de type entier
Identifie le bouton sélectionné par l'utilisateur :
Non (ou 0)L'utilisateur a choisi le bouton [NON]
ou a fermé la boîte de dialogue par l'icône 'X'.
Oui (ou 1)L'utilisateur a choisi le bouton [OUI]
<Bouton sélectionné> : Constante optionnelle de type entier
Bouton sélectionné par défaut dans la boîte de dialogue :
Non (ou 0)Le bouton "Non" est sélectionné par défaut.
Oui (ou 1)
(Valeur par défaut)
Le bouton "Oui" est sélectionné par défaut.
<Texte> : Chaîne de caractères
Texte à afficher.
<Ligne 2> : Chaîne de caractères optionnelle
Texte affiché sur la seconde ligne.
<Ligne N> : Chaîne de caractères optionnelle
Texte affiché sur la Nième ligne.
WEBDEV - Code Navigateur

Afficher une boîte de dialogue Oui / Non sur le navigateur (page interne WebDevOuiNon) Masquer les détails

OuiNon([<Bouton sélectionné>, ] <Code pour Oui> , <Code pour Non> , <Texte> [, <Ligne 2> [... [, <Ligne N>]]])
<Bouton sélectionné> : Constante optionnelle de type entier
Bouton sélectionné par défaut dans la boîte de dialogue :
Non (ou 0)Bouton [NON] sélectionné par défaut
Oui (ou 1)
(Valeur par défaut)
Bouton [OUI] sélectionné par défaut
<Code pour Oui> : Chaîne de caractères
Code à exécuter si l'internaute choisi le bouton Oui. Ce paramètre peut correspondre :
  • au nom d'un bouton. Si le bouton Oui est sélectionné, le code de clic de ce bouton sera exécuté.
  • au nom d'une fonction / procédure navigateur. Si le bouton Oui est sélectionné, cette procédure sera exécutée.
  • une chaîne ou une autre valeur. Si le bouton Oui est sélectionné, la valeur sera exécutée comme étant un code JavaScript.
<Code pour Non> : Chaîne de caractères
Code à exécuter si l'internaute choisi le bouton Non. Ce paramètre peut correspondre :
  • au nom d'un bouton. Si le bouton Non est sélectionné, le code de clic de ce bouton sera exécuté.
  • au nom d'une fonction / procédure navigateur. Si le bouton Non est sélectionné, cette procédure sera exécutée.
  • une chaîne ou une autre valeur. Si le bouton Non 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 la seconde ligne.
<Ligne N> : Chaîne de caractères optionnelle
Texte affiché sur la Nième ligne.
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.
    AndroidiPhone/iPad 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.
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.
WEBDEV - Code Serveur 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.
WEBDEV - Code Navigateur

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 OuiNon utilise la page interne nommée "WebDevOuiNon". Pour intégrer cette page dans votre projet :
  1. Cliquez sur parmi les boutons d'accès rapide.
  2. La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Page" puis sur "Page".
  3. Dans l'onglet "Page Interne", sélectionnez la page interne "Oui / Non".
  4. Validez. La page "WebDevOuiNon" est affichée sous l'éditeur.
  5. Enregistrez la page en conservant son nom par défaut.
Limitation : la fonction OuiNon ne doit pas être utilisée en code navigateur dans une page dont l'édition est de type "Tranches (Responsive historique pour compatibilité)".

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 :
OuiNon("La fiche XXX a été modifiée." + RC + ...
	"Voulez-vous la sauver avant de quitter ?")
est équivalent à :
OuiNon("La fiche XXX a été modifiée.", ...
	"Voulez-vous la sauver avant de quitter ?")
Il est également possible d'utiliser la syntaxe des chaînes multilignes. Par exemple :
OuiNon(
[
La fiche XXX a été modifiée.

Voulez-vous la sauver avant de quitter ?
])
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppAndroidiPhone/iPadJavaCode 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.
  • WEBDEV - Code Serveur La première syntaxe n'est pas disponible dans une page AWP.
  • WEBDEV - Code Serveur 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".
  • iPhone/iPad 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.
  • Android La position des boutons est dépendante de la version de Android. A partir de la version 4.1 de Android, le bouton de validation est placé à droite par le système. L'utilisation de la fonction Dialogue permet si besoin de fixer la position des boutons.
WINDEV

Pilotage

Il est possible de piloter un message OuiNon à l'aide de la fonction PiloteOuiNon.
Android

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 OuiNon 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.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
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