<Internal window>.ChangeSourceWindow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

WEBDEV

WINDEV Mobile

Others

See also

<Internal window>.ChangeSourceWindow (Function)

In french: <Fenetre interne>.ChangeFenêtreSource

Dynamically changes the window displayed in an Internal Window control. During this modification, parameters can be passed to the new internal window.

Case of internal window dequeues The <Internal window>.ChangeSourceWindow function modifies the currently displayed window. This modification is saved in the list of internal windows to scroll.

Note: This function is now available for WEBDEV projects to facilitate webification of WINDEV applications. It is recommended to use ChangeSourcePage.

Example

// Charge la fenêtre interne FI_FenêtreInterne1
// dans le champ Fenêtre interne CFI_ChampFenêtreInterne
CFI_ChampFenêtreInterne.ChangeFenêtreSource(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)
TABLE_ChampTable[IndiceLigne].CFI_ChampFenêtreInterne.ChangeFenêtreSource(...
	FI_FenêtreInterne1)

Syntax

<Internal Window control>.ChangeSourceWindow(<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 <Internal window>.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