ToastAffiche (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions de gestion des toasts

Gestion des threads
Appels successifs

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

ToastAffiche (Fonction)

En anglais : ToastDisplay

Affiche un message de type "Toast".

Le toast est un message furtif qui apparaît durant quelques secondes à l'écran avant de disparaître avec un effet de fondu sans intervention de l'utilisateur. Un toast ne prend pas le focus, il n'est pas modal et il n'interrompt pas l'exécution de l'application.

L'affichage de toasts est recommandé pour transmettre des informations à l'utilisateur sans bloquer l'exécution de l'application (exemple : affichage d'un message pour indiquer la fin d'un téléchargement).

Cette fonction est disponible uniquement pour les sites WEBDEV Linux.

Nouveauté 2025

L'affichage par défaut des toasts a été amélioré. Par défaut :

un arrondi est automatiquement appliqué aux coins du toast.
une marge externe est définie entre le bord du toast et le bord de don parent.
l'animation d'ouverture et de fermeture du toast correspond à l'animation définie dans les options du projet (option "Animations des champs", dans l'onglet "Avancé" de la description du projet).

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

ToastAffiche("Ceci est un message Toast.")

ToastAffiche("Ceci est un message Toast.", toastLong, cvMilieu, chCentre, VertClair)

// Personnalisation de la police utilisée (fonctions gxxx)
ToastAffiche(gPoliceGras() + gPolice("Batang") + gPoliceTaille(18) + ...
	gStylo(JauneClair) + "Mon message personnalisé", toastCourt, cvBas, chDroite, RougeFoncé)

Syntaxe

Afficher un toast basé sur une variable de type Toast Masquer les détails

ToastAffiche(<Toast>)

<Toast> : Variable de type Toast

Nom de la variable de type Toast décrivant le toast à afficher.
Remarque : La variable de type Toast permet de définir de nombreux paramètres.

Définir et afficher un toast Masquer les détails

ToastAffiche(<Message> [, <Durée d'affichage> [, <Cadrage Vertical> [, <Cadrage Horizontal> [, <Couleur de fond>]]]])

<Message> : Chaîne de caractères

Message à afficher. Ce message peut être multiligne.

<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.
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é.

<Cadrage Vertical> : Entier optionnel

Constante indiquant le cadrage vertical du message. Ce cadrage est relatif :
à l'écran.
à la fenêtre.
à la page.
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.

A partir de Android 11, le positionnement des toasts ne peut plus être personnalisé. Ce paramètre est ignoré.

<Cadrage Horizontal> : Entier optionnel

Constante indiquant le cadrage horizontal du message. Ce cadrage est relatif :
à l'écran.
à la fenêtre.
à la page.
chCentre
(Valeur par défaut) Affichage du message Toast au centre.
Le toast s'affiche toujours centré horizontalement.
chDroite Affichage du message Toast sur la droite.
Cette constante n'est pas disponible.
chGauche Affichage du message Toast sur la gauche.
Cette constante n'est pas disponible.

A partir de Android 11, le positionnement des toasts ne peut plus être personnalisé. Ce paramètre est ignoré.

<Couleur de fond> : Entier optionnel

Couleur de fond utilisée pour l'affichage du message. Ce paramètre peut correspondre à :
une couleur RVB (obtenue avec la fonction RVB),
une couleur TSL (obtenue avec la fonction TSL),
une couleur prédéfinie du WLangage.
Ce paramètre n'est pas disponible.

Remarques

Gestion des threads

La fonction ToastAffiche peut être appelée depuis un thread WLangage (par exemple pour notifier l'utilisateur d'événements survenus durant l'exécution du thread).

Appels successifs

Si la fonction ToastAffiche est appelée plusieurs fois, chaque toast est affiché lorsque le toast précédent a disparu. Ce comportement peut être modifié en utilisant la propriété Superposable de la variable de type Toast. Cette propriété permet de retrouver le comportement de la version 24 : les toasts se superposent les uns au-dessus des autres.

Si la fonction ToastAffiche est appelée plusieurs fois, seul le dernier appel à la fonction sera pris en compte.

Liste des exemples associés :

Exemples multiplateforme (WINDEV Mobile) : WM Système

[ + ] Cette application est un exemple didactique montrant quelques unes des fonctionnalités de WINDEV Mobile pour Android/iOS.
Les fonctions système utilisées sont :
- NFC
- Champ Multimédia
- Luminosité
- Volume
- WIFI
- Bluetooth
- Toast
- Boussole
- Accéléromètre
- Champ caméra
- LED
- Vibrations
- Notifications
- Fonctions de dessin
- Internet

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.

Classification Métier / UI : Code UI

Composante : wd300obj.dll

Voir Aussi

Version minimum requise

Version 16

Documentation également disponible pour…

Commentaires

utilisation du multi-lingue

Pour programmer les traductions des messages des Toasts en plusieurs langues (fonctions multi-lingues), en fonction de la langue choisie par l'utilisateur, se référer à :
https://doc.pcsoft.fr/fr-FR/?2013004&name=traduction_des_messages_programmation

02 déc. 2019

Affichage d'un message multi-ligne

Avec :
ToastAffiche("Please Wait..."+RC+"Requesting Data")
La première ligne est en gras et la seconde normale

Avec :
ToastAffiche("Please Wait...")
La ligne est normale (pas en Gras)

CBEK

27 nov. 2012

Dernière modification : 26/02/2025

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