PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Parameters passed to the window to open
  • Opening mode of window
  • Limitations
  • Closing a window
  • Title of window to open
  • Application in the background: Android 10 specific case
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
<Window>.OpenMobileWindow (Function)
In french: <Fenêtre>.OuvreFenêtreMobile
Opens a window in a mobile application.
Remarks:
  • This function replaces OpenChild used to open windows in a mobile application. Only the mobile feature will be presented in this documentation page. See OpenChild for more details.
  • <Window>.OpenMobileWindow is available on all products to allow for multi-product code writing. Functions or procedures that use <Window>.OpenMobileWindow can be shared between several products without generating any compilation error.
Versions 21 and later
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Apple Watch This function is now available in Apple Watch mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 24 and later
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WEBDEV - Server codeWindows This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeWindowsLinux This function is available only to simplify the Webification of WINDEV/WINDEV Mobile projects. In a WEBDEV site, this function has the same behavior as <Page>.Display.
New in version 24
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WEBDEV - Server codeWindows This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeWindowsLinux This function is available only to simplify the Webification of WINDEV/WINDEV Mobile projects. In a WEBDEV site, this function has the same behavior as <Page>.Display.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WEBDEV - Server codeWindows This function is now available for WEBDEV sites in Windows.
WEBDEV - Server codeWindowsLinux This function is available only to simplify the Webification of WINDEV/WINDEV Mobile projects. In a WEBDEV site, this function has the same behavior as <Page>.Display.
Example
WIN_EditOrder.OpenMobileWindow(gnOrderID)
Syntax
<Window>.OpenMobileWindow([<Parameter 1> [... [, <Parameter N>]]])
<Window>: Window name
Name of mobile window to open.
<Parameter 1>: Type of value sent to the window (optional)
First parameter that will be passed to the "Global declarations" event of the window to open. This parameter is passed by value and it is considered as being a variable global to the window.
This parameter cannot correspond to an array variable (arrays can only be passed by reference).
<Parameter N>: Type of value sent to the window (optional)
Nth parameter that must be passed to the "Global declarations" event of the window to open. This parameter is passed by value and it is considered as being a variable global to the window.
This parameter cannot correspond to an array variable (arrays can only be passed by reference).
Remarks

Parameters passed to the window to open

The parameters are retrieved in the event "Global declarations" 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. Caution: These parameters are passed by value and not by reference.

Opening mode of window

The window is opened in non-modal mode:
  • 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.
    AndroidiPhone/iPad The controls found in the parent windows cannot be accessed by the user as long as a child window is opened.

Limitations

  • <Window>.OpenMobileWindow must not be called in the event "Initializing" associated with the project.
  • Universal Windows 10 App <Window>.OpenMobileWindow must not be called in the event "Closing" of a child window.

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 window to open

By default, the window title is the one defined in the editor (in the "General" tab of the description window).
To modify the window title, use NextTitle or CurrentTitle.
Versions 25 and later
Android

Application in the background: Android 10 specific case

From 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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
New in version 25
Android

Application in the background: Android 10 specific case

From 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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
Android

Application in the background: Android 10 specific case

From 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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
Component : wd250obj.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment