DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions de gestion des toasts
  • Gestion des threads
  • Appels successifs
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".
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).
Message de type Toast en Android
Linux Cette fonction est disponible uniquement pour les sites WEBDEV Linux.
Exemple
ToastAffiche("Ceci est un message Toast.")
ToastAffiche("Ceci est un message Toast.", toastLong, cvMilieu, chCentre, VertClair)
WINDEV
// Personnalisation de la police utilisée (fonctions gxxx)
ToastAffiche(gPoliceGras() + gPolice("Batang") + gPoliceTaille(18) + ...
gStylo(JauneClair) + "Mon message personnalisé", toastCourt, cvBas, chDroite, RougeFoncé)
WINDEV
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
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.
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 :
  • Universal Windows 10 AppAndroidiPhone/iPad à l'écran.
  • WINDEVUniversal Windows 10 App à la fenêtre.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP à la page.
cvBas
(Valeur par défaut)
Affichage du message Toast en bas.
cvHautAffichage du message Toast en haut.
cvMilieuAffichage du message Toast au milieu.

Android 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 :
  • Universal Windows 10 AppAndroidiPhone/iPad à l'écran.
  • WINDEVUniversal Windows 10 App à la fenêtre.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP à la page.
chCentre
(Valeur par défaut)
Affichage du message Toast au centre.
iPhone/iPad Le toast s'affiche toujours centré horizontalement.
chDroiteAffichage du message Toast sur la droite.
iPhone/iPad Cette constante n'est pas disponible.
chGaucheAffichage du message Toast sur la gauche.
iPhone/iPad Cette constante n'est pas disponible.

Android 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 à :
Universal Windows 10 AppAndroid Ce paramètre n'est pas disponible.
WINDEVAndroidiPhone/iPad

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.
iPhone/iPad Si la fonction ToastAffiche est appelée plusieurs fois, seul le dernier appel à la fonction sera pris en compte.
Liste des exemples associés :
WM Système 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
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.
Classification Métier / UI : Code UI
Composante : wd290obj.dll
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
CV
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/06/2023

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