The HTML control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

HTML control

The HTML control

Overview

Creating an HTML control

Control in a page: Characteristics

Control in a report: Characteristics

See also

The HTML control

Overview

Control in a window, report, or static or dynamic page

The HTML control can be used:

In a window.
The HTML control of a window is used to display an HTML page.
This control corresponds to the HTML Display control.
In a page.
The HTML control of a page is used to display or use an HTML code or a JavaScript code. This code can correspond to HTML scripts for example. The HTML control cannot be used to display an HTML page or an HTML site. This control can only be used to display an HTML code.
In a report.
The HTML control of a report is used to print an HTML code or the content of a local page.

This help page presents only the HTML control in pages or reports. For windows, please see the page about the HTML Display control.

Use in a page

The HTML control of a page is used to display or use an HTML code or a JavaScript code. This code can correspond to HTML scripts for example. The HTML control cannot be used to display an HTML page or an HTML site. This control can only be used to display an HTML code.

An HTML control can be programmed in server code only if the control is defined as being a "Dynamic" control. The HTML control cannot be associated with an item of a data file.

Caution:

When the control is defined as being a dynamic control, it can only be assigned through programming.
The option "Forbid the execution of JavaScript scripts" is checked by default ("General" tab of control description).

If the window displayed in the HTML control contains scripts and if the user clicks active areas in this HTML control (forms, tab, ...), the requested action triggers the opening of default browser and displays the URL of HTML control in order to allow the user to run these scripts.
To allow the user to navigate inside the HTML control, uncheck "Forbid the execution of JavaScript scripts".

Creating an HTML control

Creating an HTML control in a page

To create an HTML control in a page:

On the "Creation" tab, in the "Integration" group, click "HTML".
Click where you want to create the control in the page. The control appears in the editor.

To view the characteristics of the control, select "Description" in the context menu.

Creating an HTML control in a report

To create an HTML control in a report:

On the "Creation" tab, in the "Text" group, click "HTML".
Click where the control will be created in the report. The control appears in the editor.

To view the characteristics of the control, select "Description" in the context menu.

Remark: From version 22, the HTML control in a report corresponds to an HTML Static control.

Control in a page: Characteristics

Description window

You can directly enter the HTML source code in the "General" tab of the control description window ("Edit HTML source code...").

Assignment

The encoding of the HTML code assigned through programming or by data binding in an HTML control in a page, must correspond to the encoding of the page. If the encoding of the HTML code is not identical to that of the page, the accents and special characters will not be rendered correctly.

For example, if an HTML code is used in an HTML control inside a WINDEV application, it will be encoded in UTF8. The site must also use UTF8:

On the "Project" tab, in the "Project" group, click "Description".
Select the "Language" tab.
Select the "Miscellaneous" tab.
Select "<UTF8>" in "Character set for ANSI configurations".

Control in a report: Characteristics

Description window and programming

The HTML control is an HTML Static control. You can enter text directly in the "General" tab of the control description window.. This text will be automatically converted to HTML.

The HTML control is used to display:

the content of a local HTML file.
the HTML content of an item.

To initialize the HTML control by programming, it can be assigned with:

an HTML code directly. For example:

HTM_Code = "'''Hello'''"
the path of a local HTML file.

HTM_Code = fExeDir() + "\MyHTMLFile.htm"

Remarks:

PNG and SVG images in the HTML content are not supported.
If the CSS style sheet corresponds to an external file, it is ignored.
All the external files that must be found on Internet are ignored.
JavaScript codes are not run.