ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Mobile specific functions / Phone functions
  • Behavior when a notification is received
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Specifies the WLanguage procedure called when a push notification is received by a WINDEV Mobile application (Android or iOS).
Note This function must be called in the "Initialization" event of the project, as notifications can be received at any time during the life of the application, or when the application is launched following receipt of the notification.
Example
// Initialisation du projet
NotifPushProcedure(appelNotif)
PROCEDURE appelNotif(MaNotif is Notification)
Info("Notification reçue : " + MaNotif.Message)
Syntax
NotifPushProcedure(<WLanguage procedure>)
<WLanguage procedure>: Procedure name
Name of the procedure that will be called when a push notification is received. This procedure must be a global procedure of application in the following format:
PROCEDURE <Procedure name>(<Notification> is Notification)
where <Notification> is a Notification variable corresponding to the notification sent by NotifPushSend.
Remarks

Behavior when a notification is received

The behavior when a notification is received is as follows:
  1. If the application is closed, the system displays the notification in the notification bar. The user can choose to validate the notification. If he does, the application is started.
    Android If no message is specified in the notification, the application is started and the notification is not displayed.
    Two cases may occur once the application is started:
    • If NotifPushProcedure was called in the project initialization code, the global procedure passed to this function as parameter is called, and the first window of the application is not opened.
      Note: The OpenMobileWindow function must be called in the.
    • If NotifPushProcedure has not been called, the first window of the application is opened.
  2. If the application is already started:
    • Android If a message or a title is specified in the notification, the system displays the notification in the notification bar. If the user clicks the notification, the procedure specified in NotifPushProcedure is called (nothing happens if it is not specified).
      If no message and no title is specified in the notification, the notification is not displayed and the procedure is called directly.
    • iPhone/iPad There are two possible cases:
      • If the application is in the foreground, the procedure of NotifPushProcedure is called directly. If no procedure is specified, only an "ok" button is displayed.
      • If the application is in the background, the system displays the notification. If the user validates the notification, the application returns to the foreground and the procedure of NotifPushProcedure is called.
Remarks:
  • The exeLaunch constant of ExeInfo allows you to know if the application was automatically started by the system further to the reception of a push notification:
    ExeInfo(exeLaunch) = exePushNotification
  • WinStatus allows you to check (if necessary) the existence of a window in order to open it:
    // Résumé : Procédure appelée lors du clic sur une notification PUSH
    PROCEDURE onPush(maNotif is Notification)
    
    IF WinStatus("FEN_Main") <> NotFound THEN
    	// FEN_Main est déjà ouverte ou affichée
    	RéceptionNotifPush(maNotif, True)
    ELSE
    	// On ouvre la fenêtre d'accueil
    	OpenMobileWindow(FEN_Main, maNotif)
    END
Related Examples:
WM Push Cross-platform examples: WM Push
[ + ] This example shows how to receive Push notifications.
It calls the PushNotifActive function and returns the identifier to "WD Push Server", which stores it.
Then, the "Send Push" example reads this identifier and sends Push notifications to this example.
Component: wd300android.aar
Minimum version required
  • Version 19
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help