DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions de gestion des toasts
  • Propriétés spécifiques à la description des variables de type Toast
  • Fonctions WLangage manipulant les variables de type Toast
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Le type Toast permet de définir toutes les caractéristiques avancées d'un toast à afficher. Les caractéristiques de ce toast peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
MonToast est un Toast
MonToast.Titre = "Le saviez-vous ?"
MonToast.Texte = "Les FAA sont un truc génial."
MonToast.Bouton[1].Libellé = "En savoir plus..."
MonToast.Bouton[1].ActionClic = FoncAide
MonToast.ActionFermeture = clicFerme
ToastAffiche(MonToast)
PROCÉDURE INTERNE FoncAide
	Ouvre("FEN_Aide")
FIN
PROCÉDURE INTERNE clicFerme(nBouton)
	Trace("Clic fermeture, bouton " + nBouton)
FIN
// 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)
Propriétés

Propriétés spécifiques à la description des variables de type Toast

Les propriétés suivantes peuvent être utilisées pour manipuler un toast :
Nom de la propriétéTypeEffet
ActionFermetureProcédure WLangageAction à réaliser lors de la fermeture du toast.
Cette propriété correspond au nom de la procédure à lancer lors du clic sur le bouton affiché dans le toast.
Cette procédure prend en paramètre optionnel le numéro du bouton cliqué. Si aucun bouton spécifique n'a été cliqué pour fermer le toast (fermeture par timer, clic sur le toast, fermeture de la fenêtre parent, etc.), ce paramètre vaut 0.
Nouveauté SaaS
WINDEV AnimationFermeture
Entier ou constanteAnimation du toast à réaliser lors de la fermeture du toast. Cette propriété peut prendre les valeurs suivantes :
  • -1 : Aucune animation.
  • 0 (Valeur par défaut) : Animation par défaut, définie dans les options du projet (bouton "Animations des champs" dans l'onglet "Avancé" de la fenêtre de description du projet).
  • animFondu : animation fondu enchaîné : l'opacité du toast passe de 1 à 100%.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Nouveauté SaaS
WINDEV AnimationOuverture
Entier ou constanteAnimation du toast à réaliser lors de l'ouverture du toast. Cette propriété peut prendre les valeurs suivantes :
  • -1 : Aucune animation.
  • 0 (Valeur par défaut) : Animation par défaut, définie dans les options du projet (bouton "Animations des champs" dans l'onglet "Avancé" de la fenêtre de description du projet).
  • animFondu : animation fondu enchaîné : l'opacité du toast passe de 100% à 1.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Nouveauté SaaS
WINDEV Arrondi
EntierTaille de l'arrondi à appliquer sur les coins du toast. Si cette valeur vaut 0, le toast est rectangulaire.
Par défaut, cette propriété a pour valeur 24.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Bouton[n]Boutons affichés dans le toast.
Android Un seul bouton peut être ajouté à un toast.
Bouton[n].ActionClicAction à réaliser lors du clic sur le bouton.
Cette propriété correspond au nom de la procédure à lancer lors du clic sur le bouton affiché dans le toast.
Bouton[n].LibelléLibellé du bouton.
Remarque : il est possible d'utiliser la fonction gStylo pour modifier la couleur du texte affiché dans le toast. Par exemple :
MonToast.Bouton[3].Libellé = gStylo(JauneClair) + 
	"Ne plus demander"
CadrageHorizontalConstante de type EntierCadrage horizontal du toast, relatif à la fenêtre :
  • chCentre (Valeur par défaut) : Affichage du toast au centre de la fenêtre.
  • chDroite : Affichage du toast sur la droite de la fenêtre.
  • chGauche : Affichage du toast sur la gauche de la fenêtre.
Android Non disponible.
CadrageVerticalConstante de type EntierCadrage vertical du toast, relatif à la fenêtre :
  • cvBas (Valeur par défaut) : Affichage du toast en bas de la fenêtre.
  • cvHaut : Affichage du toast en haut de la fenêtre.
  • cvMilieu : Affichage du toast au milieu de la fenêtre.
Android Non disponible.
CouleurFondEntierCouleur de fond utilisée pour l'affichage du toast. Ce paramètre peut correspondre à :
DuréeAffichageConstante de type EntierDurée d'affichage du toast :
  • toastCourt (Valeur par défaut) : Le toast sera affiché pendant une faible période de temps.
  • toastLong : Le toast sera affiché pendant une longue période de temps.
Remarque : La durée d'affichage exacte dépend de l'appareil utilisé.
FermeAuClicBooléenGestion de la fermeture du toast :
  • Vrai : Le toast se ferme automatiquement si l'utilisateur clique dessus,
  • Faux : Le toast se ferme après la durée d'affichage spécifiée.
Android Non disponible.
Nouveauté SaaS
WINDEV Image
Chaîne de caractèresChemin de l'image affichée en haut à gauche du toast.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Nouveauté SaaS
WINDEV MargeExterne
EntierMarge entre le bord du toast et le bord de la fenêtre parente (exprimée en pixels).
Par défaut, cette propriété a pour valeur 8.
Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
OpacitéEntierNiveau d'opacité du toast. La valeur de cette propriété est comprise entre 0 et 100 :
  • 0, valeur par défaut : toast légèrement transparent.
  • 1, toast transparent,
  • 100, toast complètement opaque (aucune transparence).
SuperposableBooléen
  • Vrai (valeur par défaut) : Si plusieurs toasts sont affichés, les toasts s'empilent.
  • Faux : Si plusieurs toasts sont affichés, les toasts sont affichés les uns sous les autres (compatibilité version 24).
AndroidiPhone/iPad Non disponible.
TexteChaîne de caractèresTexte affiché dans le toast.
TitreChaîne de caractèresTitre du toast.
AndroidiPhone/iPad Non disponible.
Remarques

Fonctions WLangage manipulant les variables de type Toast

ToastAfficheAffiche un message de type "Toast".
ToastAfficheFIOuvre un toast dont le contenu est basé sur une fenêtre interne.
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.
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
WD25 - Largeur fenetre limite le nombre de caractères
Il semblerait en 25 que le nombre de caractère affichable dans le Toast soit limité à la largeur de la fenêtre...
DrakeQC
28 jan. 2020

Dernière modification : 04/03/2025

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