NotifPushProcedure (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

WEBDEV

WINDEV Mobile

Others

See also

NotifPushProcedure (Function)

In french: NotifPushProcedure

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:

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.
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.
If the application is already started:
- 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.
- 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:

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.