PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
New WINDEV, WEBDEV and WINDEV Mobile 26 feature!
This content has been translated automatically. Click here to view the French version.
  • Parameters passed to the window to open
  • Opening mode of window
  • Number of opened windows
  • Closing a window
  • Title of window to open
  • Minimized window
  • Opening a component window
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
Opens a modal WINDEV or WINDEV Mobile window.
<Window>.Opens is also used to:
  • define the display position of window,
  • pass parameters to the window.
During the call to <Window>.Opens, the following actions are run:
  • the event "Global declarations" of the window is run,
  • the "Initializing" events of the controls in the window are run (the order is undefined),
  • the window "Initializing" event is run,
  • displaying the window (this window becomes the current window).
For more details on the events associated with a window, see Events associated with a window.
Remark: The controls found in the previous window are disabled.
Java In Java, the modal windows appear in the taskbar.
Versions 24 and later
Windows This function is now available for WEBDEV sites in Windows.
Windows This function is available only to simplify the Webification of WINDEV projects. In a WEBDEV site, this function has the same behavior as <Page>.DisplayDialog.
New in version 24
Windows This function is now available for WEBDEV sites in Windows.
Windows This function is available only to simplify the Webification of WINDEV projects. In a WEBDEV site, this function has the same behavior as <Page>.DisplayDialog.
Windows This function is now available for WEBDEV sites in Windows.
Windows This function is available only to simplify the Webification of WINDEV projects. In a WEBDEV site, this function has the same behavior as <Page>.DisplayDialog.
Example
// Opening and repositioning the "FEN_Saisie" window
// The Value1 and Value2 parameters are passed to the event
// "Global Declarations" from the "FEN_Saisie" window.
// ReturnedValue will retrieve the returned value
// when the "FEN_Saisie" window closes.
ValueSent = FEN_Saisie.Open( Value1, Value2)
Syntax
<Result> = <Window name>.Open up([<Parameter 1> [, <Parameter N>]])
<Result>: Type corresponding to the retrieved value (optional)
Value returned by the popup window when it is closed. This value is returned:
  • by the RESULT keyword in the "Closing" event associated with the window,
  • by ferme,
  • by the ReturnedValue property used before closing the window.
<Window name>: Control name
Corresponds to:
  • the name of window to open.
  • the name and full path of window (".WDW" file) to open.
By default, the window is displayed according to the position defined in the editor. You have the ability to define the display position of the window. The window name is completed by the display coordinates of window when it is opened. This parameter has the following format:
"<Window name>, <Y>, <X>"
where:
  • <Window name>: name (or name and full path) of window to open.
  • <Y>: Y coordinate (in pixels) of window (in relation to the top left corner of screen or parent window).
  • <X>: X coordinate (in pixels) of window (in relation to the top left corner of screen or parent window).
Remark: The coordinates are ignored if the window is defined as centered in the editor.
<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 reference and it is considered as being a variable global to the window. $~ ... |
<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 reference and it is considered as being a variable global to the window.
Remarks

Parameters passed to the window to open

The parameters are retrieved in the event "Global declarations" of the window. Simply write the following line of code at the start of the event:
PROCEDURE <Window name>(<Parameter1> [, <Parameter2> [, ...]])

See Window with parameters for more details.

Opening mode of window

The window is opened in modal mode:
  • the result of <Window>.Opens will be known once the window is closed,
  • the user will not be able to click in one of the parent windows of current window.
To manage multi-windowing, use functions <Page>.DaughterOpener or OpenSister.
To manage MDI, use <Window>.MDIOpen.

Number of opened windows

The number of windows that can be opened simultaneously depends on the available memory.

Closing a window

A window opened with <Window>.Opens can be closed with ferme (without parameters) from any event associated with the window or a control in the window.
If a parent window is closed, its child windows are also closed.

Title of window to open

By default, the window title is the one defined in the editor.
To modify the window title, use NextTitle or CurrentTitle.
Reports and QueriesWindowsJavaUser code (UMC)

Minimized window

If the current window is minimized, the entire project is minimized.
The displayed icon is:
  • the one of the current window if the current window has an icon,
  • the one of the current project if the current window has no icon.

Opening a component window

To open a component window, all you have to do is use the name of the component window (the component being included in the project). For example:
ComponentWindow.Open()
If a conflict occurs with a project element, the name of the element must be prefixed by the name of the component. For example:
My.Open( Window )
To use the name of the window in an Variable, it is necessary to specify the name of the component.. For example:
sWindow is string = "MyComponent.MyWindow"
sFenêtre.Open()
Component: wd260obj.dll
Minimum version required
  • Version 26
This page is also available for…
Comments
Click [Add] to post a comment