ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Toast functions
  • Gestion des threads
  • Successive calls
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Displays a "Toast" message.
Toasts are a short messages that appear on the screen for a few seconds before fading out without any user intervention. A Toast message does not gain focus, it is not modal and it does not interrupt the execution of the application.
Toasts are recommended to show information to the user without locking the execution of the application (e.g.: display a message to indicate that the download has been completed).
Toast message in Android
Linux This function is available for Linux WEBDEV sites only.
Example
ToastDisplay("Ceci est un message Toast.")
ToastDisplay("Ceci est un message Toast.", toastLong, vaMiddle, haCenter, LightGreen)
WINDEV
// Personnalisation de la police utilisée (fonctions gxxx)
ToastDisplay(gFontBold() + gFont("Batang") + gFontSize(18) + ...
gPen(LightYellow) + "Mon message personnalisé", toastShort, vaBottom, haRight, DarkRed)
WINDEV
MyToast is Toast
MyToast.Title = "Did you know?"
MyToast.Text = "AAFs are really cool."
MyToast.Button[1].Caption = "Learn more..."
MyToast.Button[1].ActionClick = FuncHelp
MyToast.ActionClose = clickClose
ToastDisplay(MyToast)
INTERNAL PROCÉDURE FuncHelp
Open ("WIN_Help")
END
INTERNAL PROCÉDURE clickClose(nButton)
Trace("Click to close. Button: " + nButton)
END
Syntax

Defining and displaying a toast Hide the details

ToastDisplay(<Message> [, <Display duration> [, <Vertical alignment> [, <Horizontal alignment> [, <Background color>]]]])
<Message>: Character string
Message to display. This message can be multiline
<Display duration>: Optional integer
Constant indicating the display duration of the Toast message:
toastLongThe Toast message will be displayed during a long period of time.
toastShort
(Default value)
The Toast message will be displayed during a short period of time.

Remark: The exact display duration depends on the device used.
<Vertical alignment>: Optional integer
Constant indicating the vertical alignment of message. This alignment is relative:
  • Universal Windows 10 AppAndroidiPhone/iPad to the screen.
  • WINDEVUniversal Windows 10 App to the window.
  • WEBDEV - Server codeWEBDEV - Browser codePHP to the page.
vaBottom
(Default value)
The Toast message is displayed at the bottom.
vaMiddleThe Toast message is displayed in the middle.
vaTopThe Toast message is displayed at the top.

Android Starting with Android 11, it is no longer possible to set the position of toast messages. This parameter is ignored.
<Horizontal alignment>: Optional integer
Constant indicating the horizontal alignment of the message. This alignment is relative:
  • Universal Windows 10 AppAndroidiPhone/iPad to the screen.
  • WINDEVUniversal Windows 10 App to the window.
  • WEBDEV - Server codeWEBDEV - Browser codePHP to the page.
haCenter
(Default value)
The Toast message is displayed in the center.
iPhone/iPad The toast will always be centered horizontally.
haLeftThe Toast message is displayed on the left.
iPhone/iPad This constant is not available.
haRightThe Toast message is displayed on the right.
iPhone/iPad This constant is not available.

Android Starting with Android 11, it is no longer possible to set the position of toast messages. This parameter is ignored.
<Background color>: Optional integer
Background color used to display the message. This parameter can be:
Universal Windows 10 AppAndroid This parameter is not available.
WINDEVAndroidiPhone/iPad

Displaying a toast based on a Toast variable Hide the details

ToastDisplay(<Toast>)
<Toast>: Toast variable
Name of the Toast variable that defines the toast to be displayed.
Remark: The Toast variable allows you to define additional parameters.
Remarks

Gestion des threads

ToastDisplay can be called from a WLanguage thread (to notify the user of events that occurred during the thread execution for example).

Successive calls

If ToastDisplay is called several times, each toast is displayed once the previous toast has disappeared. This behavior can be changed using the Overlayable property of the Toast variable. This property allows you to get the same behavior as in version 24: toasts overlap each other.
iPhone/iPad If ToastDisplay is called several times, only the last call to the function will be taken into account.
Related Examples:
WM System Cross-platform examples (WINDEV Mobile): WM System
[ + ] This application is an example of some of the features of WINDEV Mobile available for Android/iOS.
The following system functions are used:
- NFC
- Multimedia control
- Brightness
- Volume
- Wi-Fi
- Bluetooth
- Toast
- Compass
- Accelerometer
- Camera control
- LED
- Vibration
- Notifications
- Drawing functions
- Internet
WD Toasts Training (WINDEV): WD Toasts
[ + ] This example shows how to use the ToastDisplay and ToastDisplayIW functions as well as Toast variables. A Toast is a temporary message used to inform the user without interrupting the application.
Business / UI classification: UI Code
Component: wd290obj.dll
Minimum version required
  • Version 16
This page is also available for…
Comments
Notification
https://repository.windev.com/resource.awp?file_id=281474976710849;notificationdisplay
BOLLER
30 Aug. 2019
Exemplo Toastdisplay
Exemplo Toastdisplay

ToastDisplay("Mensagem que apareça",toastLong,vaTop,haCenter,LightBlue)

ToastDisplay("Outra Mensagem")

//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/07/curso-windev-funcoes-dialogo-4_12.html
https://www.youtube.com/watch?v=m3471CzfOIk
De matos AMARILDO
12 Jul. 2016

Last update: 06/27/2023

Send a report | Local help