|
|
|
|
|
|
|
|
|
|
- Parameters passed to the sibling window to open
- Window opening mode
- Opening the same window several times
- Closing a window
- Title of the window to be opened
- Opening the window of a component
OpenSister (Function) In french: OuvreSoeur Opens a non-modal sibling window. OpenSister is also used to: - define the position of the sibling window,
- pass parameters to the sibling window.
The following operations are performed when OpenSister is called: - the "Global declarations" event 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.
Note: By default, the sister window retains focus once open.
// Open the sibling window named "EDT_EditWindow"
// without positioning and without passing parameters
OpenSister(WIN_EditWindow)
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 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 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 be a variable of type array (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 can define the display position of the window. The window name is completed by the window display coordinates when opened. This parameter has the following format:
"[<Alias>] = <Window name> [, <Y>, <X>]"
where:
- <Alias>: window alias if the same window is opened several times.
- <Nom de la fenêtre> name of the sister window to be opened.
 To avoid giving focus to the opened window, use the following notation: <Window name> + NoFocus. The event "Gain of focus" of the sibling window will not be run. Warning: in this case, the window name must be enclosed in quotation marks. - <Y>: vertical coordinate (in pixels) of window display (relative to top left corner of screen or parent window).
- <X>: horizontal coordinate (in pixels) of window display (relative to top left corner of screen or parent window).
Note: If the window is declared centered in the editor, the coordinates are ignored..
It is recommended to use WinSize to change the position of a window. - the window display level (<Level>):
| | | Above | Window opened above all its sibling windows. | | AboveAll | Window opened above all the other windows (including the windows of other applications). |
Note: If two windows are opened with the same constant (Above or AboveAll), the second window will be opened above the first window..
It is recommended to use WinStatus 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 be a variable of type array (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 be a variable of type array (arrays can only be passed by reference). Remarks Parameters passed to the sibling window to open The parameters are retrieved in the "Global declarations" event of the window. Simply write the following line of code at the start: PROCEDURE <Window name>(<Parameter1> [, <Parameter2> [, ...]]) 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.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|