The HTML control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Creating an HTML control

Window control: Characteristics

Page control: Characteristics

Report control: Characteristics

Related examples

See also

The HTML control

Overview

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

Versions 16 and later

The HTML controls are now available for the Android applications.

New in version 16

The HTML controls are now available for the Android applications.

Versions 17 and later

HTML controls are now available for iPhone/iPad applications.

New in version 17

HTML controls are now available for iPhone/iPad applications.

Versions 18 and later

HTML fields are now available for Windows Store apps.

New in version 18

HTML fields are now available for Windows Store apps.

The HTML control can be used:

In a window.
The HTML control of a window is used to display an HTML page.
Versions 26 and later
This Control corresponds to the HTML Display control.
New in version 26
This Control corresponds to the HTML Display control.
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.
Versions 18 and later
In a report.
The HTML control of a report is used to print an HTML code or the content of a local page.
New in version 18
In a report.
The HTML control of a report is used to print an HTML code or the content of a local page.
In a report.
The HTML control of a report is used to print an HTML code or the content of a local page.

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 by 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 window

Versions 26 and later
In a window, the HTML Control corresponds to the HTML display Control.

New in version 26
In a window, the HTML Control corresponds to the HTML display Control.

In a window, the HTML Control corresponds to the HTML display Control.

To create an HTML display Control in a:

On the "Creation" pane, in the "Other controls" group, expand "HTML" and select "HTML Display".
Click at the desired location to create the control. 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 page

To create an HTML control in a page:

On the "Creation" pane, 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" pane, 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.

Window control: Characteristics

Options of the "General" tab

The "General" tab found in the description window of control is used to:

type HTML code or the address of HTML page to display.
Remark: Any HTML code entered must be between the <HTML> and </HTML> tags.
forbid the execution of scripts. This option is used to allow (or prevent) the execution of scripts called from the HTML code of the control.
This option is ignored: the execution of scripts is always allowed.
Versions 23 and later
If this option is unchecked, you can:
- execute Javascript code in the context of the Web page displayed by the control HTML. To do so, use ExecuteJS.
- allow the execution of WLanguage procedures from the JavaScript code via the option "Allow the WLanguage call from the HTML code (JavaScript WL.Execute function)".
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter> corresponds to a character string that will be passed to the procedure. This parameter is mandatory.
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter N> corresponds to the different parameters to be passed to the Procedure:
  Number of parameters:
  between 0 and N.
  between 0 and 10.
  Type of parameters:
  The Procedure WLanguage parameters will be passed according to their type as boolean, string, number, null.
  The Procedure WLanguage parameters will always be passed as a string.
  Example:
  - WLanguage procedure
    
    PROCEDURE ProcFromJS(t)
    ToastDisplay("Called from JS: " + t)
  - Code of HTML control:
    
    s is string = [
    <html>
    <head>
    <title> A simple example
    </title>
    <script>
    function myFunction()
    {
    WL.Execute("ProcFromJS","titaa");
    }
    </script>
    </head>
    <body>
    <h1> This is an HTML page </h1>
    <p id="demo">A paragraph</p>
    <button type="button" onclick="myFunction()">Try</button>
    </body>
    </html>
    ]
    HTM_NoName1 = s
New in version 23
If this option is unchecked, you can:
- execute Javascript code in the context of the Web page displayed by the control HTML. To do so, use ExecuteJS.
- allow the execution of WLanguage procedures from the JavaScript code via the option "Allow the WLanguage call from the HTML code (JavaScript WL.Execute function)".
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter> corresponds to a character string that will be passed to the procedure. This parameter is mandatory.
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter N> corresponds to the different parameters to be passed to the Procedure:
  Number of parameters:
  between 0 and N.
  between 0 and 10.
  Type of parameters:
  The Procedure WLanguage parameters will be passed according to their type as boolean, string, number, null.
  The Procedure WLanguage parameters will always be passed as a string.
  Example:
  - WLanguage procedure
    
    PROCEDURE ProcFromJS(t)
    ToastDisplay("Called from JS: " + t)
  - Code of HTML control:
    
    s is string = [
    <html>
    <head>
    <title> A simple example
    </title>
    <script>
    function myFunction()
    {
    WL.Execute("ProcFromJS","titaa");
    }
    </script>
    </head>
    <body>
    <h1> This is an HTML page </h1>
    <p id="demo">A paragraph</p>
    <button type="button" onclick="myFunction()">Try</button>
    </body>
    </html>
    ]
    HTM_NoName1 = s
If this option is unchecked, you can:
- execute Javascript code in the context of the Web page displayed by the control HTML. To do so, use ExecuteJS.
- allow the execution of WLanguage procedures from the JavaScript code via the option "Allow the WLanguage call from the HTML code (JavaScript WL.Execute function)".
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter> corresponds to a character string that will be passed to the procedure. This parameter is mandatory.
  If this option is selected, in the HTML code of control, all you have to do is use WL.Execute to run a WLanguage procedure. The following syntax must be used:
  
  WL.Execute(<Name of WLanguage Procedure>, <Parameter>)
  
  where:
  <Name of WLanguage procedure> corresponds to the name of the procedure to be run.
  CAUTION: The WLanguage procedure must necessarily expect a single parameter.
  <Parameter N> corresponds to the different parameters to be passed to the Procedure:
  Number of parameters:
  between 0 and N.
  between 0 and 10.
  Type of parameters:
  The Procedure WLanguage parameters will be passed according to their type as boolean, string, number, null.
  The Procedure WLanguage parameters will always be passed as a string.
  Example:
  - WLanguage procedure
    
    PROCEDURE ProcFromJS(t)
    ToastDisplay("Called from JS: " + t)
  - Code of HTML control:
    
    s is string = [
    <html>
    <head>
    <title> A simple example
    </title>
    <script>
    function myFunction()
    {
    WL.Execute("ProcFromJS","titaa");
    }
    </script>
    </head>
    <body>
    <h1> This is an HTML page </h1>
    <p id="demo">A paragraph</p>
    <button type="button" onclick="myFunction()">Try</button>
    </body>
    </html>
    ]
    HTM_NoName1 = s

Versions 23 and later

Managing local images

When going to version 23, the local images found in an HTML control may not be displayed anymore. Indeed, for security reasons, loading local images found in the "Documents" directory is not allowed. It is recommended to use fTempDir rather than fResourceDir.

New in version 23

Managing local images

Incompatibility between the IE ActiveX (and oAuth2) and the use of .NET assembly

When an HTML control is used in WINDEV, this control is using the system "Microsoft Web browser" ActiveX. This ActiveX is also used by WINDEV for all OAuth2 authentications (Facebook, Twitter, Google, etc.) that require a validation for the connection via HTML code.

If an HTML control (or an OAuth2 authentication) and a ".Net"assembly are used in the same project, an incompatibility may occur between the .NET layers of Microsoft and the ActiveX.

An API can be used to manage this cohabitation. To do so, the following code line must be used in the initialization code of the project or in the initialization code of classes or global procedure if the ".Net" object is initialized in the class or in the set of procedures:

// Used to manage the cohabitation between IE ActiveX and .NET
API("OLE32", "CoInitializeEx", Null, 2)

Page control: Characteristics

Description window

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

Report control: Characteristics

Versions 18 and later

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:

The images in PNG and SVG format found in the HTML 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.
The JavaScript codes are not run.

New in version 18

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:

The images in PNG and SVG format found in the HTML 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.
The JavaScript codes are not run.

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:

The images in PNG and SVG format found in the HTML 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.
The JavaScript codes are not run.

Related Examples:

Unit examples (WINDEV): The HTML control

[ + ] Using an HTML control

Unit examples (WEBDEV): HTMLClass property

[ + ] The property ..HTMLClass allows you to read and update the control's HTML attribute "class".
This property lets you select the CSS Style applied on the control.

Cross-platform examples (WINDEV Mobile): WM HTML Dialog

[ + ] This example explains how to dialog with an HTML control.
It is using the WLanguage "ExecuteJS" function and the Javascript "WL.Execute" function.