PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Caractéristiques de la boîte de dialogue
  • Saut de ligne dans la boîte de dialogue
  • Divers
  • Pilotage
  • Application en arrière-plan : Spécificité Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Affiche un message dans une boîte de dialogue standard proposant les réponses "Oui", "Non", "Annuler" et renvoie la réponse de l'utilisateur.
Exemple de confirmation
Remarques :
  • Cette fenêtre d'avertissement est bloquante. Pour continuer l'exécution de l'application, l'utilisateur doit valider un des boutons.
    Versions 25 et supérieures
    WINDEVAndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ConfirmerAsynchrone.
    Nouveauté 25
    WINDEVAndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ConfirmerAsynchrone.
    WINDEVAndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ConfirmerAsynchrone.
  • 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 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
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 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
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.
Versions 24 et supérieures
Ajax Cette fonction est désormais disponible en mode Ajax.
Nouveauté 24
Ajax Cette fonction est désormais disponible en mode Ajax.
Ajax Cette fonction est désormais disponible en mode Ajax.
Exemple
WINDEVEtats et RequêtesAndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaCode Utilisateur (MCU)
Res est un entier
TitreSuivant("Modification de fiche")
Res = Confirmer("Des modifications ont été apportées à la fiche.", ...
"Souhaitez-vous les enregistrer avant de sortir de la fiche ?")
SELON Res
CAS Oui : SauveFiche() // Traitement de sauvegarde
CAS Non : Ferme()
CAS Annuler : RepriseSaisie()
FIN
WEBDEV - Code Navigateur
Res est un booléen
Res = Confirmer("Êtes-vous sûr de vouloir charger cette page ?")
SI Res = Vrai ALORS
// L'utilisateur a validé
SINON
// L'utilisateur n'a pas validé
RepriseSaisie("BTNVALID")
FIN
Syntaxe
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsLinuxAndroidiPhone/iPadUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Afficher une boîte de dialogue Confirmer Masquer les détails

<Résultat> = Confirmer([<Bouton sélectionné>, ] <Texte> [, <Ligne 2> [... [, <Ligne n>]]])
<Résultat> : Constante de type entier
Identifie le bouton sélectionné par l'utilisateur :
Non0L'utilisateur a choisi le bouton [NON].
Oui1L'utilisateur a choisi le bouton [OUI].
Annuler2L'utilisateur a choisi le bouton [ANNULER].
<Bouton sélectionné> : Constante optionnelle de type entier
Bouton sélectionné par défaut dans la boîte de dialogue :
Non0sélectionné par défaut.
Oui
(Valeur par défaut)
1sélectionné par défaut.
Annuler2sélectionné par défaut.
<Texte> : Chaîne de caractères (avec guillemets)
Texte à afficher.
<Ligne 2> : Chaînes de caractères optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
<Ligne n> : Chaînes de caractères optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
WEBDEV - Code Navigateur

Afficher une boîte de dialogue Confirmer sur le navigateur Masquer les détails

<Résultat> = Confirmer(<Texte> [, <Ligne 2> [... [, <Ligne n>]]])
<Résultat> : Booléen
  • Vrai si l'internaute a validé,
  • Faux dans le cas contraire.
<Texte> : Chaîne de caractères Unicode (avec guillemets)
Texte à afficher.
<Ligne 2> : Chaînes de caractères Unicode optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
<Ligne n> : Chaînes de caractères Unicode optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
Remarques

Caractéristiques de la boîte de dialogue

  • Le message est cadré à gauche.
  • Les libellés des boutons dépendent de la langue d'exécution de Windows (ou du poste Navigateur dans le cas d'un site WEBDEV).
  • 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 dans une application WINDEV, point d'interrogation dans une application WEBDEV) ne peut pas être modifiée.
  • 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.
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.
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 (OuiNon et OKAnnuler)" dans l'onglet "Ambiance" de la fenêtre de 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 (OuiNon et OKAnnuler)" dans l'onglet "Ambiance" de la fenêtre de 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 (OuiNon et OKAnnuler)" dans l'onglet "Ambiance" de la fenêtre de description du projet.

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 :
Confirmer("La fiche XXX a été modifiée." + RC + ...
"Voulez-vous la sauver avant de quitter ?")
est équivalent à :
Confirmer("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 :
Confirmer(
[
La fiche XXX a été modifiée.
 
Voulez-vous la sauver avant de quitter ?
])

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.
  • 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 l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "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 l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "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 l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation du projet après connexion au site".
  • 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.
WINDEV

Pilotage

Il est possible de piloter un message de confirmation à l'aide de la fonction PiloteConfirmer.
Versions 25 et supérieures
Android

Application en arrière-plan : Spécificité 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 Confirmer 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.
Nouveauté 25
Android

Application en arrière-plan : Spécificité 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 Confirmer 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.
Android

Application en arrière-plan : Spécificité 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 Confirmer 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.
Composante : wd250obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire