PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Caractéristiques de la boîte de dialogue
  • Affichage de la boite de dialogue
  • Saut de lignes 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Pour fermer la fenêtre, l'utilisateur doit valider un des boutons.
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.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)
// Suppression d'une ligne avec confirmation (oui par défaut)
SI OKAnnuler("Supprimer cet enregistrement ?") ALORS
        HSupprime(CLIENT)
FIN
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)
// Choix pour la sortie du programme
SI OKAnnuler("Voulez-vous quitter le programme?") = Oui ALORS
Ferme()
FIN
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal 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
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadUniversal 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 :
Nonsélectionné par défaut
Vrai
(par défaut)
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.
WEBDEV - Code Navigateur

Afficher une boite 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 :
NonBouton [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 (entre guillemets)
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 (entre guillemets)
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 (entre guillemets)
Texte à afficher.
<Ligne 2> : Chaîne de caractères optionnelle (entre guillemets)
Texte affiché sur les lignes suivantes.
<Ligne N> : Chaîne de caractères optionnelle (entre guillemets)
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 en cours.
    iPhone/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. 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 "Appliquer le thème de gabarit sur les fenêtres d'information système" 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 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.
Versions 16 et supérieures
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 (Info, OuiNon, Confirmer, ...)" dans l'onglet "Style" de la description du projet.
Nouveauté 16
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 (Info, OuiNon, Confirmer, ...)" dans l'onglet "Style" de la description du projet.
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 (Info, OuiNon, Confirmer, ...)" dans l'onglet "Style" de la description du projet.
WEBDEV - Code Navigateur

Affichage de la boite 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 :
  1. Sélectionnez l'option "Fichier .. Nouveau .. Page".Cliquez sur parmi les boutons d'accès rapide. Dans la roue qui s'affiche, cliquez sur "Page". La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Page" puis sur "Page".
  2. Dans l'onglet "Page Interne", sélectionnez la page interne "OK / Annuler".Cliquez sur "Page interne" dans l'assistant et sélectionnez la page interne "OK / Annuler".
  3. Validez. La page "WEBDEVOKAnnuler" est affichée sous l'éditeur.
  4. Enregistrez la page en conservant son nom par défaut.

Saut de lignes 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
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Divers

  • Les timers (fonction TimerSys) et les événements ne sont pas stoppés lors de l'appel de cette fonction.
  • WINDEV Lors de la saisie de la fonction sous l'éditeur de code, vous pouvez utiliser l'assistant de code. Selon les caractéristiques saisies dans l'assistant, la fonction utilisée peut être différente dans le code automatiquement généré.
  • WINDEVWindows MobileJava 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.
  • Versions 20 et supérieures
    WEBDEV - Code Serveur Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans le traitement "Initialisation du projet". Cette fonction doit être utilisée dans le traitement "Initialisation du projet après connexion au site".
    Nouveauté 20
    WEBDEV - Code Serveur Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans le traitement "Initialisation du projet". Cette fonction doit être utilisée dans le traitement "Initialisation du projet après connexion au site".
    WEBDEV - Code Serveur Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans le traitement "Initialisation du projet". Cette fonction doit être utilisée dans le traitement "Initialisation du projet après connexion au site".
  • iPhone/iPad Cette fonction ne doit pas être utilisée :
    • dans le traitement de modification de taille des fenêtres. Dans le cas contraire, l'application sera bloquée.
    • dans le traitement de changement d'orientation des fenêtres.
    • dans le traitement de "Mise au premier-plan" associé au projet.
      Remarque : La fonction peut par contre être utilisée dans le traitement "Mise au premier plan" d'une fenêtre.
    • dans un thread.
WINDEV

Pilotage

Il est possible de piloter un message OkAnnuler à l'aide de la fonction PiloteOkAnnuler.
Composantes
WINDEVEtats et Requêtes wd230obj.dll
WEBDEV - Code Serveur wd230page.dll
Windows Mobile wp230obj.dll
WEBDEV - Code Navigateur WDJS.DLL
Java wd230java.jar
Linux wd230obj.so
Android wd230android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire