ToastAffiche (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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 message Toast ne prend pas le focus, il n'est pas modal et il n'interrompt pas l'exécution de l'application.

L'affichage des 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.

Versions 17 et supérieures

Cette fonction est désormais disponible dans les applications WINDEV pour Windows.

Nouveauté 17

Cette fonction est désormais disponible dans les applications WINDEV pour Windows.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible en WEBDEV Serveur (Windows et Linux).

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible en WEBDEV Serveur (Windows et Linux).

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible en WEBDEV Serveur (Windows et Linux).

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 20 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 20

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Exemple

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

Versions 25 et supérieures

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
ToastAffiche(MonToast)
PROCÉDURE INTERNE FoncAide
Ouvre("FEN_Aide")
FIN

Nouveauté 25

Syntaxe

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.

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

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

Versions 25 et supérieures

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 des paramètres supplémentaires.

Nouveauté 25

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 des paramètres supplémentaires.

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 des paramètres supplémentaires.

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 l'un au-dessus de l'autre.

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 : wd270obj.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 : 28/03/2022

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