The HTML control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / HTML control

Overview
Control in a window, report, or static or dynamic page
Use in a page
Creating an HTML control
Creating an HTML control in a page
Creating an HTML control in a report
Control in a page: Characteristics
Description window
Assignment
Control in a report: Characteristics
Description window and programming

WINDEV

WEBDEV

WINDEV Mobile

Others

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 displays an HTML page.
This control corresponds to the HTML Display control.
In a page.
The HTML control of a page displays or uses HTML code or JavaScript code. This code can correspond to HTML scripts. The HTML control does not display HTML pages or sites. It only displays HTML code.
In a report.
The HTML control of a report can be used to print HTML code or the contents 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 displays or uses HTML code or JavaScript code. This code can correspond to HTML scripts. The HTML control does not display HTML pages or sites. It only displays HTML code.

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

Caution:

When the control is defined as dynamic, you can only assign values programmatically.
The "Don't allow the execution of JavaScript scripts" option is checked by default ("General" tab of the control description).

If the window displayed in the HTML control contains scripts and the user clicks the active areas of the HTML control (forms, tabs, etc.), the default browser opens and displays the URL of the HTML control to allow the user to run the scripts.
To allow the user to navigate inside the HTML control, uncheck "Don't allow 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 you want to create the control. The control appears in the editor.

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

Remark: Starting with version 22, the HTML control of a report is an Static control of type HTML.

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 programmatically or by data binding in an HTML control of 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, accents and special characters will not be rendered correctly.

For example, if HTML code is used in the HTML control of a WINDEV application, it will be encoded in UTF-8. The site must also use UTF-8:

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 a Static control of type HTML. 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 displays:

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

You can programmatically initialize the HTML control by assigning:

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.