ChangeSourceWindow (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Code run when changing the internal window
Limitations
..SourceWindow property

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ChangeSourceWindow (Function)

In french: ChangeFenêtreSource

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

Versions 18 and later

Case of scrolling internal windows: ChangeSourceWindow is used to modify the window currently displayed. This modification is saved in the list of internal windows to scroll.

New in version 18

Case of scrolling internal windows: ChangeSourceWindow is used to modify the window currently displayed. This modification is saved in the list of internal windows to scroll.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 20 and later

This function is now available for WINDEV applications in Linux.

New in version 20

This function is now available for WINDEV applications in Linux.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

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
// ("GUI" 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>: Character string (with or without quotes)

Name of the Internal Window control that will be modified.

<Internal window>: Character string (with or without quotes)

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

Code run when changing the internal window

The following events are run when ChangeSourceWindow is used:

Versions 17 and later
Event "Before unloading the internal window". This event is associated with the Internal Window control.
New in version 17
Event "Before unloading the internal window". This event is associated with the Internal Window control.
Event "Before unloading the internal window". This event is associated with the Internal Window control.
Event "Closing" of the old internal window.
Event "Global declarations" of the new internal window.
Event "Initializing" of the controls in the new internal window.
Event "Initializing" of the internal window.
Versions 17 and later
Event "After loading the internal window". This event is associated with the Internal Window control.
New in version 17
Event "After loading the internal window". This event is associated with the Internal Window control.
Event "After loading the internal window". This event is associated with the Internal Window control.

Limitations

The names and the parameters of the functions called must be identical.
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

..SourceWindow is used to find out the name of the internal window currently displayed in an "Internal Window" control.

Component : wd250obj.dll