MyInternalWindow is used to handle the current internal window. When running the internal window,
MyInternalWindow is replaced with the internal window (and not by the name of the internal window). The
MyInternalWindow keyword is used like an internal window.
Benefit: The MyInternalWindow keyword can be used to make a local code (control, button, etc.) or a global code (global procedure, class, etc.) independent of the current internal window.
// Retrieve the background color of the current internal window
BackgroundColor = MyInternalWindow.BackgroundColor
Remarks
Handling the current internal window
- The MyInternalWindow keyword is always replaced by the current internal window. For example, using the BackgroundColor property:
MyInternalWindow.BackgroundColor = LightRed
MyColor = MyInternalWindow.BackgroundColor
// Pass as parameter:
CallProcedure(MyInternalWindow)
- If the MyInternalWindow keyword is to be converted to a string, the result of the Value property is returned. You can assign a value to this property programmatically.
Trace(MyInternalWindow) // Displays the Value property of the internal window
Example not to do:
ExecuteProcess(MyInternalWindow, trtChange)
To do:
ExecuteProcess(MyInternalWindow.Name, trtChange)
- The MyInternalWindow keyword can only be used in processes or events that manipulate a window (e.g., processes associated with a control, a window, etc.). The MyInternalWindow keyword 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 or event being run (in this case, MyInternalWindow is equivalent to MyWindow).
- The MyInternalWindow keyword does not allow using global variables declared in the internal window.
- To handle a control in an internal window using the MyInternalWindow keyword, you can use the following syntax:
Info({MyInternalWindow.Name + ".Button2"}..Caption)
Using MyInternalWindow in a procedure
MyInternalWindow can be used in a local or global procedure only if this procedure manipulates the current internal window. In that case, MyInternalWindow refers to the current internal window.
In 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 as parameter, use:
- an empty string,
- the MyInternalWindow keyword 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 |
The
MyInternalWindow keyword can only be used from a window event or procedure.