MyInternalWindow is used to handle the current internal window. When running the internal window,
MyInternalWindow is replaced by the internal window (and not by the name of the internal window). The
MyInternalWindow keyword is used like an internal window.
Benefit: MyInternalWindow is used to make a local code (control, button, ...) or a global code (global procedure, class, ...) independent of the current internal window.
// Retrieve the background color of the current internal window
BackgroundColor = MyInternalWindow..BackgroundColor
Remarks
Handling the current internal window
- MyInternalWindow is always replaced by the current internal window. For example, using ..BackgroundColor:
MyInternalWindow..BackgroundColor = LightRed
MyColor = MyInternalWindow..BackgroundColor
// Pass in parameter:
CallProcedure(MyInternalWindow)
- If MyInternalWindow must be converted into string, it is the result of ..Value that is returned. This property can be assigned by programming.
Trace(MyInternalWindow) // Displays the ..Value property of the internal window
Example not to do:
ExecuteProcess(MyInternalWindow, trtChange)
To do:
ExecuteProcess(MyInternalWindow..Name, trtChange)
- MyInternalWindow can only be used in the processes that handle a window (in the processes associated with a control, a window, ...). MyInternalWindow cannot be used in a report. To specify the current report in a report, use MyReport
- If there is no current internal window, MyInternalWindow returns the main window that contains the process currently run (in this case, MyInternalWindow is equivalent to MyWindow).
- MyInternalWindow does not allow you to use the global variables declared in the internal window.
- To handle a control found in an internal window by using MyInternalWindow, you have the ability to use the following syntax:
Info({MyInternalWindow..Name + ".Button2"}..Caption)
Using MyInternalWindow in a procedure
MyInternalWindow can be used in a local of global procedure only if the procedure handles the current internal window. In this case, MyInternalWindow references the current internal window.
For a local procedure, MyInternalWindow corresponds to the internal window to which the procedure belongs.
WLanguage functions and current internal window
To specify the current internal window in the WLanguage functions that accept a name of internal window in parameter, use:
- an empty string,
- MyInternalWindow directly.
| |
| Code where MyInternalWindow is used | MyInternalWindow corresponds to |
| internal window | internal window |
| control of internal window | internal window |
| procedure of internal window with a direct call from a code of the internal window | internal window |
| procedure of internal window with a call via <InternalWindow>.<Procedure> | internal window |
| supercontrol of internal window | internal window |
| control of supercontrol of internal window | internal window |
| procedure of supercontrol of internal window with a direct call from a code of the supercontrol | internal window |
| procedure of supercontrol of internal window with a call via <Supercontrol>.<Procedure> | internal window |
| internal window control | internal window |
MyInternalWindow can only be used from a window process or procedure.