ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Internal Window functions
  • Parameters passed to the internal window to be opened
  • Events executed when changing the internal window
  • Limitations
  • SourceWindow property
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
Dynamically changes the window displayed in an Internal Window control. During this modification, parameters can be passed to the new internal window.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst Scrolling internal windows: ChangeSourceWindow allows you to modify the window currently displayed. This modification is saved in the list of internal windows to scroll.
WEBDEV - Server code Remark: This function is now available for WEBDEV projects to make the webification of WINDEV applications easier. It is recommended to use ChangeSourcePage.
Example
// Load the internal window IW_InternalWindow1
// in the Internal Window control IWC_InternalWindowControl
ChangeSourceWindow(IWC_InternalWindowControl, IW_InternalWindow1)
// Load the internal window IW_InternalWindow1,
// on the row RowIndex of an Internal Window control named IWC_InternalWindowControl
// in a Container column of a Table control
// Caution: the IWC_InternalWindowControl control must have
// the option "Identical content for all the rows" unchecked
// ("UI" tab of the description window)
ChangeSourceWindow(TABLE_TableControl[RowIndex].IWC_InternalWindowControl, ...
IW_InternalWindow1)
Syntax
ChangeSourceWindow(<Internal Window control> , <Internal window> [, <Parameter 1> [... [, <Parameter N>]]])
<Internal Window control>: Control name
Name of the Internal Window control that will be modified.
<Internal window>: Character string
Name of the internal window that will be associated with the Internal Window control.
<Parameter 1>: Type corresponding to the parameter (optional)
First parameter that will be passed to the internal window.
<Parameter N>: Type corresponding to the parameter (optional)
Nth parameter that will be passed to the internal window.
Remarks

Parameters passed to the internal window to be opened

Parameters are retrieved in the "Global declarations" event of the internal window. Simply write the following line of code at the start of the event:
PROCEDURE <Internal Window name>(<Parameter1> [, <Parameter2> [, ...]])

For more details, see Window with parameters.

Events executed when changing the internal window

The following events are executed when ChangeSourceWindow is called:
  • Event "Before unloading the internal window". This event is associated with the Internal Window control.
  • Event "Closing" of the old internal window.
  • "Global declarations" event of the new internal window.
  • "Initializing" event of the controls in the new internal window.
  • "Initializing" event of the internal window.
  • Event "After loading the internal window". This event is associated with the Internal Window control.

Limitations

  • The names and parameters of the called functions must be identical in both windows.
  • If a control found in the internal window is directly used from outside, a control with the same name must be found in the new internal window.
  • The values of global variables for the former internal window are lost.
  • The persistent values of the former internal window are saved and restored in the new one.

SourceWindow property

The SourceWindow property returns the name of the internal window currently displayed in an "Internal Window" control.
Component: wd290obj.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help