ChangeSourceWindow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Internal Window functions

ChangeSourceWindow

Presentation

Example

Parameters passed to the internal window to be opened

Events executed when changing the internal window

Limitations

SourceWindow property

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.

Scrolling internal windows: ChangeSourceWindow allows you to modify the window currently displayed. This modification is saved in the list of internal windows to scroll.

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: wd270obj.dll