Handling an Internal Window control by programming

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Internal Window control

Handling an Internal Window control by programming

Overview

Programming in WLanguage

Example: File picker created via an internal window

See also

Handling an Internal Window control by programming

Overview

The "Internal Window" control is used to display an existing internal window. Several operations can be performed on the Internal Window control by programming.

Caution: Do not confuse "Internal Window control" and "Internal window": the "Internal window" control is a type of control while the "Internal window" is a type of window.

Versions 17 and later

Internal windows are now available for iPhone/iPad applications.

New in version 17

Internal windows are now available for iPhone/iPad applications.

Versions 20 and later

Internal windows are now available for WINDEV applications in Linux.

New in version 20

Internal windows are now available for WINDEV applications in Linux.

Programming in WLanguage

Available functions and properties

The following WLanguage functions and properties are available:

WLanguage functions:


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

WLanguage property:
SourceWindow Used to find out the source of an internal window (which means the internal window displayed by the Internal Window control).

Versions 18 and later

Several functions are also available to make the internal windows scroll in an Internal Window control via a simple finger gesture. For more details, see Changing the content of an internal window by gesture.

New in version 18

Passing parameters to an internal window

To pass parameters to an internal window, we advise you to:

Create an initialization procedure in the internal window.
Call this procedure in the window that contains the "Internal Window" control.Example:

// -- Initialization code of WIN_Window1
// IW_MyInternalWin is a control of WIN_Window1
// That is linked to an internal window
// This internal window includes a procedure named Init()
IW_MyInternalWin.Init(Param1, Param2)

Remark: ChangeSourceWindow is used to dynamically change the internal window displayed in an Internal Window control. During this modification, you have the ability to pass parameters to the internal window.

Operating mode of groups of controls

The groups of controls are global to the window and to its internal windows. The groups of controls found in two internal windows displayed in the same window are not differentiated.

Therefore, hiding a group of controls found in an internal window can also hide the controls found in another internal window if the internal windows use the same name for the groups of controls.

Example: File picker created via an internal window

Retrieving the default value of the file picker

To retrieve the default value of the file picker in the internal window:

In the initialization code of the host window for example, initialize the value of the internal window:

IW_InternalWindow1 = "C:\temp"
In the "Assign Property Value" event of the internal window, for example, retrieve the value and assign this value to the edit control of the selector:

EDT_DirEdit = MySelf.Value

Transmitting the value typed in the internal window

To transmit the value typed by the user to the host window:

In the "Retrieve Property Value" event of the internal window, enter:

RESULT EDT_DirEdit
In the host window, all you have to do is retrieve the value of the internal window control:

Info(IW_InternalWindow1.Value)