<Window>.OpenMobileWindow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions

Parameters passed to the window to open
Window opening mode
Limitation
Closing a window
Title of the window to be opened
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Window>.OpenMobileWindow (Function)

In french: <Fenêtre>.OuvreFenêtreMobile

Opens a window in a mobile application.

Remarks:

This function replaces <Window>.OpenChild used to open windows in a mobile application. Only the mobile feature will be presented in this documentation page. For more details, see <Window>.OpenChild.
<Window>.OpenMobileWindow can be used in all IDEs to allow for cross-platform code. Functions or procedures that use <Window>.OpenMobileWindow can be shared between several products without generating any compilation error.

Remarks:

By default, the window retains focus once open.
<Window>.OpenMobileWindow can also be used to pass parameters to the child window.
- In standard syntax, these parameters are passed directly.
- Subscription-exclusive new feature
  When you use a variable of type Window to open a window, you can use the OpeningParameters property to pass parameters.
  Note: This feature is only available in subscription-based versions, starting with WINDEV Suite 2025 - Update 4.
  For more details, see Using new features exclusive to the subscription-based version of WINDEV Suite 2025.

This function is available only to simplify the Webification of WINDEV/WINDEV Mobile projects. In a WEBDEV website, this function has the same behavior as <Page>.Display.

Example

WIN_EditOrder.OpenMobileWindow(gnOrderID)

MyMobileWindow is Window WIN_EditOrder
MyMobileWindow.OpeningOptions.Title = "Edit Order"
MyMobileWindow.OpeningParameters.OrderNumber = gnOrderID
MyMobileWindow.OpenMobileWindow()

Syntax

Opening a window (standard syntax) Hide the details

<Window>.OpenMobileWindow([<Parameter 1> [... [, <Parameter N>]]])

<Window>: Window name

Name of the mobile window to open.

<Parameter 1>: Type of value sent to the window (optional)

First parameter to be passed to the "Global declarations" event of the window to open. This parameter is passed by value and is considered a variable global to the window.
This parameter cannot be a variable of type array (arrays can only be passed by reference).

<Parameter N>: Type of value sent to the window (optional)

Nth parameter to be passed to the "Global declarations" event of the window to open. This parameter is passed by value and is considered a variable global to the window.
This parameter cannot be a variable of type array (arrays can only be passed by reference).

Subscription-exclusive new feature

This syntax is only available for Java applications

Opening a window (with a Window variable) Hide the details

<Window to open>.OpenMobileWindow([<Parameter 1> [... [, <Parameter N>]]])

<Window to open>: Window

Name of the Window variable corresponding to the window to be opened.
The window opening options must have been defined using the OpeningOptions property.
The value of the parameters expected by the window must have been defined using the OpeningParameters property.

<Parameter 1>: Type of value sent to the window (optional)

First parameter to be passed to the "Global declarations" event of the window to open. This parameter is passed by value and is considered a variable global to the window.
This parameter cannot be a variable of type array (arrays can only be passed by reference).
Note: Parameter values can also be defined using the OpeningParameters property, which can be used in conjunction with a variable of type Window.

<Parameter N>: Type of value sent to the window (optional)

Nth parameter to be passed to the "Global declarations" event of the window to open. This parameter is passed by value and is considered a variable global to the window.
This parameter cannot be a variable of type array (arrays can only be passed by reference).
Note: Parameter values can also be defined using the OpeningParameters property, which can be used in conjunction with a variable of type Window.
Note: This feature is only available in subscription-based versions, starting with WINDEV Suite 2025 - Update 4.
For more details, see Using new features exclusive to the subscription-based version of WINDEV Suite 2025.

Remarks

Parameters passed to the window to open

The parameters are retrieved in the "Global declarations" event associated with the window. The first line of code of this event must correspond to the following line:

PROCEDURE <Window> (<Parameter 1> [, ... [, <Parameter N>]])

where:

<Window> must correspond to the name of the window.
<Parameter N> must correspond to the parameters expected. Note: These parameters are passed by value, not by reference.

For more details, see Window with parameters.

Window opening mode

The window opens as a non-modal window:

the opened window becomes the current window.
after the window opening, the processes following the call to <Window>.OpenMobileWindow in the parent window are run.
the user will have the ability to click one of the parent windows of opened window.
The controls found in the parent windows cannot be accessed by the user as long as a child window is opened.

Limitation

<Window>.OpenMobileWindow must not be called in the "Initialization" event associated with the project.

Closing a window

A window opened with <Window>.OpenMobileWindow can be closed with Close (without parameters) from any event associated with the window or a control in the window.

Title of the window to be opened

By default, the window title is the one defined in the editor (in the "General" tab of the description window).

To change the window title:

In standard syntax, use NextTitle or CurrentTitle.
Subscription-exclusive new feature
With a variable of type Window, use the OpeningOptions property (OpeningOptions.Title).
Note: This feature is only available in subscription-based versions, starting with WINDEV Suite 2025 - Update 4.
For more details, see Using new features exclusive to the subscription-based version of WINDEV Suite 2025.

Application in the background: Specific case from Android 10

Starting with Android 10, it is no longer possible to open a window when the application is in the background.

<Window>.OpenMobileWindow can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Behavior of applications in the background.

Component: wd300obj.dll