PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Parameters passed to the sibling window to open
  • Window opening mode
  • Opening the same window several times
  • Closing a window
  • Title of window to open
  • Opening a component window
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Opens a non-modal sibling window. OpenSister is also used to:
  • define the display position of sibling window,
  • pass parameters to the sibling window.
The following operations are performed when OpenSister is called:
  • the event "Global declarations" of the sibling window is run,
  • running the initialization events of the controls (the order is undefined),
  • running the processes following the call to OpenSister of calling window,
  • displaying the sibling window.
Remark: By default, the sibling window keeps focus once it is opened.
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 PageDisplay.
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 PageDisplay.
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 PageDisplay.
// Ouverture de la fenêtre soeur "FEN_SaisieFenêtre"
// sans positionnement et sans passage de paramètres
OpenSister(FEN_SaisieFenêtre)
Syntax

Opening a sibling window Hide the details

OpenSister(<Window name> [, <Parameter 1> [... [, <Parameter N>]]])
<Window name>: Character string
  • Name of sibling window to open.
  • Name and full path of sibling window (".WDW" file) 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 is considered 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 is considered a variable global to the window.
This parameter cannot correspond to an array variable (arrays can only be passed by reference).

Opening a sibling window while defining its position and its display level Hide the details

OpenSister(<Window name [ + <Level>]> [, <Parameter 1> [... [, <Parameter N>]]])
<Window name [ + <Level>]>: Character string
Used to specify:
  • the window to open (<Window name>). This parameter can correspond to:
    • Name of sibling window to open.
    • Name and full path of sibling 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:
    "[<Alias>] = <Nom de la fenêtre> [, <Y>, <X>]"

    where:
    • <Alias>: alias of the window if the same window is opened several times.
    • <Window name>: name of sibling window to open.
    • <Y>: vertical display coordinate (in pixels) of window (in relation to the top left corner of screen or parent window).
    • <X>: horizontal display coordinates (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.
    It is advisable to use the WinSize function to change the display position of a window.
  • the window display level (<Level>):
    AboveWindow opened above all its sibling windows.
    AboveAllWindow opened above all the other windows (including the windows of other applications).
    Remark: If two windows are opened with the same constant (Above or AboveAll), the second window will be opened above the first one.
    It is recommended to use the WinStatus function to change the display level of a window.
<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 is considered 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)
Last parameter that will 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 correspond to an array variable (arrays can only be passed by reference).
Remarks

Parameters passed to the sibling 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:
PROCEDURE <Nom de la fenêtre>(<Paramètre1> [, <Paramètre2> [, ...]])
These parameters are passed by value and not by reference.

Window opening mode

The window is opened in non-modal mode:
  • the parent window remains the current window.
  • once the sibling window is opened, the processes following the call to OpenSister in the calling window are run.
  • the user will have the ability to click one of the parent windows of current window.

Opening the same window several times

  • If the same window is opened several time, we recommend that you use an alias. This alias is used to differentiate between each window.
  • The position of the calling window (relative to the screen or to the sibling window) is chosen when the window is described in the editor. If the same window is opened several times (with an alias), the display positions must be modified at each opening (otherwise the windows will be stacked).
  • The number of windows that can be opened simultaneously depends on the available memory.

Closing a window

A window opened with OpenSister can be closed with Close (without parameters) from any event:
  • of the window,
  • of a window control.
Reports and QueriesWindows

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 QueriesWindows

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:
OpenSister(FenêtreDuComposant)
If a conflict occurs with a project element, the element name must be prefixed by the component name. For example:
OpenSister(MonComposant.Fenêtre)
To use the name of the window in a variable, the name of the component must be specified. For example:
sFenêtre is string = "MonComposant.MaFenêtre"
OpenSister(sFenêtre)
Component: wd270obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment