ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
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
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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.
AndroidiPhone/iPadIOS WidgetMac Catalyst Case of internal window dequeues The ChangeSourceWindow function modifies the currently displayed window. This modification is saved in the list of internal windows to scroll.
Example
// Charge la fenêtre interne FI_FenêtreInterne1
// dans le champ Fenêtre interne CFI_ChampFenêtreInterne
ChangeSourceWindow(CFI_ChampFenêtreInterne, FI_FenêtreInterne1)
// Charge la fenêtre interne FI_FenêtreInterne1, 
// à la ligne IndiceLigne d'un champ Fenêtre interne nommé CFI_ChampFenêtreInterne 
// contenu dans une colonne de type Conteneur d'un champ Table
// Attention : le champ CFI_ChampFenêtreInterne doit avoir 
// l'option "Contenu identique pour toutes les lignes" non cochée 
// (onglet "UI" de la fenêtre de description)
ChangeSourceWindow(TABLE_ChampTable[IndiceLigne].CFI_ChampFenêtreInterne, ...
	FI_FenêtreInterne1)
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 to be passed to the internal window.
<Parameter N>: Type corresponding to the parameter (optional)
Nth parameter to be passed to the internal window.
Remarks

Parameters passed to the internal window to be opened

Parameters are specified 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.
  • "Initialization" event of the controls in the new internal window.
  • "Initialization" 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: wd300obj.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help