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
  • Saut de ligne dans la boîte de dialogue
  • Divers
  • 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 personnalisé dans une fenêtre d'avertissement système non bloquante.
Exemple de message d'avertissement
Remarques :
  • Cette fenêtre d'avertissement est non bloquante. Le code WLangage qui suit l'appel à la fonction AvertissementAsynchrone continue de s'exécuter. Pour fermer la fenêtre, l'utilisateur doit valider le bouton OK. Quand l'utilisateur clique sur le bouton "OK", il est possible d'exécuter le code d'une procédure WLangage.
  • Dans le code WLangage suivant l'appel de la fonction, l'ouverture d'une autre fenêtre modale n'est pas possible avant la fermeture de la boîte de dialogue.
  • 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
DélaiAvantFermeture(20 s)
TitreSuivant("Attention")
AvertissementAsynchrone("Cette manipulation n'a pas été validée" + ...
	RC + "Contactez le responsable de l'application", Procédure_ValidationOK)

PROCÉDURE INTERNE Procédure_ValidationOK()
ToastAffiche("Rappel : Manipulation non validée")
FIN

ExécuteTraitement(BTN_Suivant, trtClic)
Syntaxe
AvertissementAsynchrone(<Texte> [, <Procédure WLangage>])
<Texte> : Chaîne de caractères
Texte à afficher.
<Procédure WLangage> : Nom de procédure ou procédure lambda, optionnel
Nom de la procédure WLangage (appelée "callback") appelée lorsque l'utilisateur clique sur le bouton "OK" de la fenêtre d'avertissement.
Cette procédure WLangage peut correspondre à :
  • un nom de procédure globale,
  • un nom de procédure interne,
  • une procédure lambda.
Si ce paramètre n'est pas spécifié, aucune procédure n'est exécutée lorsque l'utilisateur clique sur le bouton "OK" de la fenêtre d'avertissement.
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.
  • Le libellé du bouton dépend 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 dans un triangle jaune) 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 :
AvertissementAsynchrone("La fiche XXX a été modifiée." + RC + ...
	"Toute nouvelle modification devra être validée.")
Il est également possible d'utiliser la syntaxe des chaînes multilignes. Par exemple :
AvertissementAsynchrone(
[
Cette manipulation n'a pas été validée.

Contactez le responsable de l'application.
])

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 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é du bouton s'affiche dans la langue utilisée par Windows sur le poste en cours.
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 AvertissementAsynchrone 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 : wd300obj.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

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