The Internal Window control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Internal Window control

The Internal Window control

Overview of the "Internal window" control

Creating an internal window and associating it with a control

Remarks

Related examples

See also

The Internal Window control

Overview of the "Internal window" control

Window control

The "Internal Window" control is used to include a window (and its code) in a control found in another window.

At runtime, the Internal window will be dynamically merged with the host window.

The "Internal Window" control is used to dynamically share the same interface section between one or more applications. The window to merge (internal window) can also come from a component.

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.

Creating an internal window and associating it with a control

Creating an internal window

To create an internal window:

Click in the quick access buttons.
The creation window appears: click "Window" then "Window". The window creation wizard starts automatically.
Click the "Internal window" tab and select "Blank" (select the associated skin template if necessary). Validate to create the window.

An internal window corresponds to a specific type of window. The internal window contains no border, no title bar, no status bar and no background image. It is intended to be displayed in an "Internal window" control.

This type of window is also called "Source window".

Remarks:

In the "UI" tab of the description window, you have the ability to specify whether the source window must use the skin template of the target window. To do so, simply check the option "Applies the skin template of project of the host window".
A blank internal window can also be created as follows:
- Click in the quick access buttons.
- The creation window appears: click "Window" then "Internal window".
- The internal window is automatically created in the editor.
If the internal window is used on different platforms, in portrait or landscape mode, you have the ability to define layouts. For more details, see Managing layouts.

Creating an "Internal window" control

To create an "Internal window" control:

On the "Creation" tab, in the "Containers" group, click "Internal window".
Click the position where the control must be created in the target window. The control appears in the editor.

To view the characteristics of the control, select "Description" in the context menu. This enables you to select the internal window that will be displayed in the "Internal Window" control when initializing the target window.

You have the ability to scroll the internal windows in an Internal Window control with a simple touch gesture. For more details, see Changing the content of an internal window by gesture.

Creating an internal window from existing controls

To create an internal window from existing controls:

Select the controls that must be included in the internal window.
Use one of the following methods:
- Display the popup menu of the selection and select "Refactoring .. Create an internal window from the selection".
- On the "Modification" tab, in the "Transformations" group, expand "Refactoring and swapping" and select "Create an internal window from the selection".

The Internal Window control and the internal window are automatically created. The internal window is automatically associated with the control.

Creating an internal window from a window (and conversely)

To create an internal window from the current window, go to the "Home" tab, "General" group, expand "Save" and select "Save as an internal window".
To create a window from the current internal window, go to the "Home" tab, "General" group, expand "Save" and select "Save as a window".

Remarks

Limitations

Main menus can be created in the Internal Window controls but they will be disabled.

Apply project skin template

If the internal window is included in a component, the skin template of the host project can be applied to the internal window ("Apply the skin template of the host project (component only)" from the "UI" tab in the description window of the internal window).

This option is ignored if the internal window is not included in a component.

Applying a window template to an internal window

To apply one or more window templates to an internal window:

Display the internal window in the window editor.
On the "Window" tab, in the "Templates" group, expand "Templates" and select "Inherit from a template".
Select the window template to apply.
Validate.
Specify whether the properties of the internal window must be updated from the template. If you answer "Yes", the list of properties to override is displayed. In this window, you have the ability to select the properties of the internal window to keep. The window template will be automatically overridden for the properties kept. For all the other characteristics, the internal window will be automatically linked to the template.
Validate.

Remark: By default, the size characteristics of the internal window are automatically overridden.

Displaying the preview of the internal windows at100%

By default, the internal windows displayed in the "Internal Window" controls are minimized in the editor.

To display the preview of the internal windows at 100% for the entire project:

On the "Display" tab, click the dialog box launcher () of the "Options" group.
In the "Controls" tab of the edit options, check "Force preview of internal windows at 100%".
Validate.

To display the preview of an internal window at 100%, check "Always display the preview at 100%" in the "UI" tab of the description window of the Internal Window control.

Related Examples:

Sample components (WINDEV): WD Explorer Bar

[ + ] The WD Explorer Bar component is used to manage an address bar similar to the address bar of the explorer found in Windows Vista.
This address bar (also called 'Explorer Breadcrumb') is used to easily navigate in a treeview.
You have the ability to add elements by programming, like a TreeView control.
You also have the ability to fill the address bar via a TreeView control, and even from one or more HFSQL data files.
The navigation in the bar is automatically managed by the component via an internal window.
You also have the ability to branch the call to a WLanguage user procedure when an element is clicked.

Complete examples (WINDEV): WD FTP File Transfer

[ + ] WD FTP file transfer

This example is a full FTP client allowing you to store several FTP servers. Then, you have the ability to perform multi-file transfers from the local computer to the server or from the FTP server to the local computer. To do so, we are using the standard functions of WLanguage (FTPConnect, etc...)