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
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
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)
Remarques

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éType manipuléEffet
ActionFermetureAction à 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.
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 message, relatif à la fenêtre :
  • chCentre (Valeur par défaut) : Affichage du message Toast au centre.
  • chDroite : Affichage du message Toast sur la droite.
  • chGauche : Affichage du message Toast sur la gauche.
Android Non disponible.
CadrageVerticalConstante de type EntierCadrage vertical du message, relatif à la fenêtre :
  • cvBas (Valeur par défaut) : Affichage du message Toast en bas.
  • cvHaut : Affichage du message Toast en haut.
  • cvMilieu : Affichage du message Toast au milieu.
Android Non disponible.
CouleurFondEntierCouleur de fond utilisée pour l'affichage du message. Ce paramètre peut correspondre à :
DuréeAffichageConstante de type EntierDurée d'affichage du message toast :
  • toastCourt (Valeur par défaut) : Le message Toast sera affiché pendant une faible période de temps.
  • toastLong : Le message 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.
OpacitéEntierNiveau d'opacité du toast dont la valeur est comprise entre 1 et 100 :
  • 1, toast sans aucune opacité,
  • 100, pour obtenir un toast complètement opaque.
Par défaut, le niveau d'opacité est 0 (ce qui correspond à une opacité à 100).
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èresMessage à afficher.
TitreChaîne de caractèresTitre du toast.
AndroidiPhone/iPad Non disponible.

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 : 22/06/2023

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