|
|
|
|
|
|
|
|
|
|
- Parameters passed to the child window to open
- Window opening mode
- Position of parent window
- Opening the same window several times
- Limitation
- Closing a window
- Title of the window to be opened
- Opening the window of a component
OpenChild (Function) In french: OuvreFille
 Not available
Opens a non-modal child window. OpenChild is also used to: - define the display position of child window,
- pass parameters to the child window.
The following events are run when OpenChild is called: - "Global declarations" of the child window,
- control initialization codes (undefined order),
- processes/events after the call to the OpenChild function of the parent window,
- the child window is displayed.
Remark: By default, the child window retains focus once opened.
OpenChild(FEN_SaisieFenêtre)
OpenChild(FEN_SaisieFenêtre, SAI_SaisieClient)
PROCEDURE FEN_SaisieFenêtre(Client)
HReadSeek(Client, NomClient, Client)
IF HFound() = True THEN
FileToScreen()
ELSE
Error("Aucun client ne correspond")
END
Syntax
Opening a child window Hide the details
OpenChild(<Window> [, <Parameter 1> [... [, <Parameter N>]]])
<Window>: String or window name - Name of child window to open.
- Name and full path of child 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 child window while defining its position and its display level Hide the details
OpenChild(<Window name [ + <Level>]> [, <Parameter 1> [... [, <Parameter N>]]])
<Window name [ + <Level>]>: Character string + Integer constant Used to specify: - the window to open (<Window name>). This parameter can correspond to:
- Name of child window to open.
- Name and full path of child 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 child window to be opened.
- <Y> Corner: vertical coordinate (abscissa in pixels) of window display (relative to top left corner of screen or parent window).
- <X> Horizontal coordinate (ordinate 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).
|
If one of these constants is used, the name of the window must be enclosed in quotes.
Note: If two windows are opened with the same constant (Top or TopAll), 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) 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). Remarks Parameters passed to the child 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, not by reference.
Window opening mode The window is opened in non-modal mode: - the child window becomes the current window.
- once the child window is opened, the processes following the call to OpenChild in the parent window are run.
- the user will have the ability to click one of the parent windows of opened window.
Position of parent window The parent window always remains below the child window, even if the parent window is in edit. If this situation is not suitable, the child window must be opened by OpenSister (providing that the parent window is a non-modal window). Limitation OpenChild must not be called in the project initialization code.
Closing a window A window opened with OpenChild can be closed with Close (without parameters) from any event: - of the window,
- of a window control.
If a parent window is closed, its child windows are also closed. Title of the window to be opened By default, the window title is the one defined in the editor. Opening the window of a component To open the window of a component, simply use the name of the component window (component included in the project). For example: OpenChild(FenêtreDuComposant)
If a conflict occurs with a project element, the element name must be prefixed by the component name. For example: OpenChild(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"
OpenChild(sFenêtre)
Business / UI classification: UI Code
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|