ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / System notification functions
  • Properties specific to sysNotificationButton variables
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
sysNotificationButton (Variable type)
In french: sysNotificationBouton
The sysNotificationButton type is used to define all the advanced characteristics of Button control in an interactive notification. You can define and change the characteristics of this Button control using different WLanguage properties.
The sysNotificationButton type is used by sysNotification variables.
Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
// Create a notification with a button of each type.
notif is sysNotification
notif.Title = "Many buttons"
notif.Text1 = "Download now to get the latest features."
notif.Note = "UPD_notif"
//normal button
notif.Buttons[1].Caption = "Normal"
notif.Buttons[1].Note = "btn_normal"
//button in the context menu of the notification
notif.Buttons[2].Caption = "Context"
notif.Buttons[2].Note = "btn_context"
notif.Buttons[2].Type = sysNotifContextButton
//button with a wait animation
notif.Buttons[3].Caption = "Wait"
notif.Buttons[3].Note = "btn_wait"
notif.Buttons[3].PendingUpdate = True
//reminder button
notif.Buttons[4].Caption = "Reminder"
notif.Buttons[4].Type = sysNotifReminderButton
//closing system button
notif.Buttons[5].Caption = "Close"
notif.Buttons[5].Type = sysNotifCloseButton

SysNotificationSend(notif)
Properties

Properties specific to sysNotificationButton variables

The following properties can be used to handle a button in a notification:
Property nameType usedEffect
ActionGlobal procedure onlyName of the global procedure to be executed when the user clicks the button.
If the procedure is not specified or cannot be found, the "Receive a notification" optional project event is executed.
New in version 2025
AssociatedTextInputName
Character stringAssociates the button with an Edit control in the notification. The button will be displayed next to the control.
Note If a style has been defined for the button (Styleproperty), the style will be ignored.
Note: This property is only available from version 2025 Update 1.
CaptionCharacter stringButton caption.
ImagePathCharacter stringAbsolute path of an image on disk that can be added to the content of the button, next to the text.
NoteCharacter stringInformation to be sent to the application when the user clicks the button.
PendingUpdateBoolean
  • True to display a wait animation on the button when the user clicks on it, while preventing the notification from closing until a new notification with the same ID is sent.
  • False (default) to set no wait animations on the button. The notification closes when the button is clicked.
New in version 2025
Style
Integer constantAllows you to select a style/color for the button:
  • sysNotifButtonStyleDefault (default value): Default style.
  • sysNotifButtonStyleCritical: Style used for errors, red button.
  • sysNotifButtonStyleSuccess: Style used for successful operations, green button.
The button style is defined by Windows. Different Windows versions may apply different effects. Windows 11 supports both colors, whereas Windows 10 only supports green.
Note: This property is only available from version 2025 Update 1.
TypeInteger constantSpecific behavior or positioning of the button:
  • sysNotifContextButton: Button to be added to the context menu of the notification.
  • sysNotifCloseButton: System button that automatically closes the notification.
  • sysNotifStandardButton (default value): Simple button.
  • sysNotifReminderButton: "Remind later" system button.
Related Examples:
WD Windows Notification Management Training (WINDEV): WD Windows Notification Management
[ + ] Starting with Windows 10, "toast" notifications (on the right side of the Desktop) are interactive, and enable you to include buttons, input areas and combo boxes.
This example shows how to use this type of notifications.
Minimum version required
  • Version 27
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/04/2025

Send a report | Local help