DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions de gestion des toasts
  • Fonctionnement
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 de type Toast dont le contenu est basé sur une fenêtre interne.
Exemple
// Affiche un toast avec le nom produit supprimé
MonToast est un Toast
MonToast.DuréeAffichage = toastLong
MonToast.CadrageVertical = cvBas
MonToast.CadrageHorizontal = chCentre
ToastAfficheFI(FI_TOAST_SUPPR, MonToast, PRODUIT.NOM)
 
//------------------------------------
// Déclarations globales de la fenêtre interne
PROCÉDURE FI_TOAST_SUPPR(nomProduit)
LIB_TEXTE = ChaîneConstruit("Le produit %1 a été supprimé", nomProduit)
Syntaxe

Afficher un toast basé sur une fenêtre interne (via la variable Toast) Masquer les détails

ToastAfficheFI(<Fenêtre interne> [, <Toast> [, <Paramètre 1> [... [, <Paramètre N>]]]])
<Fenêtre interne> : Nom de fenêtre interne
Nom de la fenêtre interne servant de base pour le toast.
Si ce paramètre est le seul spécifié, le toast correspondant à la fenêtre interne sera affiché à la position par défaut (en bas) avec le délai d'affichage par défaut (court).
<Toast> : Variable optionnelle de type Toast
Nom de la variable de type Toast décrivant les caractéristiques du toast.
Remarque : Les propriétés Titre, Texte et Bouton de la variable de type Toast ne sont pas prises en compte.
<Paramètre 1> : Type correspondant au paramètre (optionnel)
Premier paramètre à passer à la fenêtre interne. Ce paramètre est passé à l'événement "Déclarations globales" associé à la fenêtre interne.
<Paramètre N> : Type correspondant au paramètre (optionnel)
Nième paramètre à passer à la fenêtre interne. Ce paramètre est passé à l'événement "Déclarations globales" associé à la fenêtre interne.

Définir et afficher un toast basé sur une fenêtre interne Masquer les détails

ToastAfficheFI(<Fenêtre interne> [, <Durée d'affichage> [, <Cadrage vertical> [, <Cadrage horizontal> [, <Couleur de fond>]]]])
<Fenêtre interne> : Nom de fenêtre interne
Nom de la fenêtre interne servant de base pour le toast.
Si ce paramètre est le seul spécifié, le toast correspondant à la fenêtre interne sera affiché à la position par défaut (en bas) avec le délai d'affichage par défaut (court).
<Durée d'affichage> : Entier optionnel
Constante indiquant la durée d'affichage du message Toast :
toastCourt
(Valeur par défaut)
Le message Toast sera affiché pendant une faible période de temps.
toastLongLe message Toast sera affiché pendant une longue période de temps.

Remarque : La durée d'affichage exacte dépend de l'appareil utilisé.
<Cadrage vertical> : Entier optionnel
Constante indiquant le cadrage vertical du message. Ce cadrage est relatif à la fenêtre.
cvBas
(Valeur par défaut)
Affichage du message Toast en bas.
cvHautAffichage du message Toast en haut.
cvMilieuAffichage du message Toast au milieu.
<Cadrage horizontal> : Entier optionnel
Constante indiquant le cadrage horizontal du message. Ce cadrage est relatif à la fenêtre.
chCentre
(Valeur par défaut)
Affichage du message Toast au centre.
chDroiteAffichage du message Toast sur la droite.
chGaucheAffichage du message Toast sur la gauche.
<Couleur de fond> : Entier optionnel
Couleur de fond utilisée pour l'affichage du message. Ce paramètre peut correspondre à : Attention : Pour que la couleur de fond de la fenêtre interne puisse être modifiée, il est nécessaire d'utiliser la couleur de fond "Transparente" sous l'éditeur.
Remarques

Fonctionnement

  • Le contenu des champs de la fenêtre interne (texte, etc.) doit être initialisé avant l'appel de la fonction ToastAfficheFI. La première syntaxe permet de passer des paramètres à la fenêtre interne si nécessaire.
  • Si la fonction ToastAfficheFI est utilisée pour afficher plusieurs toasts à la fois, les différents toasts s'afficheront les uns après les autres (lorsque le premier toast sera fermé, le toast suivant sera affiché). Ce comportement peut être modifié en utilisant la propriété Superposable de la variable de type Toast.
  • La taille du toast correspond par défaut à la taille de la fenêtre interne source. Cette taille peut être modifiée / adaptée dans l'événement "Initialisation" de la fenêtre interne source.
Liste des exemples associés :
WD Toasts Exemples didactiques (WINDEV) : WD Toasts
[ + ] Cet exemple présente de façon didactique les différentes utilisations possibles des fonctions ToastAffiche et ToastAfficheFI ainsi que l'utilisation des variables de type Toast. Un Toast est un message furtif pour communiquer une information à l'utilisateur sans interrompre le fonctionnement de l'application.
Composante : wd300obj.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/09/2022

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