The HTML Display 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 Display control

Overview of the HTML Display control
Creating an HTML Display control
Characteristics of HTML Display controls
Options of the "General" tab
Options of the "Details" tab, "HTML/JavaScript"
Options of the "Details" tab, "IE/Edge ActiveX (compatibility)"
"Enable zoom" ("UI" tab in the control description window)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

The HTML Display control

Overview of the HTML Display control

The HTML Display control displays a web page in an application. Thus, in one line of code, without using an external browser, your WINDEV and WINDEV Mobile applications can display a page from a website. This control is based on Chromium Embedded Framework (CEF).

Creating an HTML Display control

To create an HTML Display control:

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

Characteristics of HTML Display controls

Options of the "General" tab

The "General" tab of the control description window allows you to directly enter HTML code or the address of the HTML page to be displayed.
Remark: Any HTML code entered must be between the <HTML> and </HTML> tags.

Options of the "Details" tab, "HTML/JavaScript"

The "Details" tab of the control description window includes the following options in "HTML/JavaScript":

Don't allow the execution of JavaScript scripts:
This option allows or prevents the execution of scripts called from the HTML code of the control.
This option is ignored: the execution of scripts is always allowed.
If this option is unchecked, you can:
- execute JavaScript code in the context of the web page displayed by the HTML Display control. To do so, use the ExecuteJS function.
- allow the execution of WLanguage procedures from the JavaScript code via the option "Allow calling WLanguage code from HTML code (JavaScript WL.Execute function)".
  If this option is selected, simply use WL.Execute in the HTML code of the control to execute a WLanguage procedure. The following syntax must be used:
  WL.Execute(<WLanguage procedure name>, <Parameter 1>) [, ... [, <Parameter N>]]] )
  where:
  - <WLanguage procedure name> corresponds to the name of the procedure to be executed.
  - <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 parameters of the WLanguage procedure will be passed according to their type: boolean, string, number, null.
      - The parameters of the WLanguage procedure will always be passed as strings.
  Caution:
  - The procedure cannot return any values.
  - The call to the WLanguage procedure is non-blocking.
  Example:
  - WLanguage procedure
    PROCÉDURE ProcFromJS(t)
    ToastDisplay("Called from JS: " + t)
  - Code of the 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
Allow popups:
With this option, you can enable JavaScript popups (for example, allow opening JavaScript menus as popups).

Options of the "Details" tab, "IE/Edge ActiveX (compatibility)"

The "Details" tab of the control description window includes the Use IE/Edge ActiveX to display content (compatibility) option in IE/Edge ActiveX (compatibility). This option allows you to use the HTML Display control via the Internet Explorer ActiveX plug-in (and no longer Chromium CEF). You can then select the desired rendering engine.

Caution: To use an HTML Display control in "IE/Edge ActiveX (compatibility)" mode:

in a WINDEV application, Internet Explorer 4 or later (version 11 recommended) must be installed on the development computer and on the deployment computer. WINDEV's HTML Display control is in Internet Explorer 7 mode.
To display WEBDEV pages in this control, they must be generated in HTML + Edge mode.
in an application in simulator mode, Internet Explorer 4 or later (version 11 recommended) must be installed on the development computer.
in an iOS 9.0 application (and later), you must respect the security options. By default, the HTML Display control can only access sites that use an HTTPS connection in compliance with Apple's guidelines. To access other sites (HTTP for example), you must either provide the list of corresponding domains, or disable the security options for all domains. These operations are performed in the iOS application creation wizard. For more details, see Generating an iOS application.

"Enable zoom" ("UI" tab in the control description window)

The "Enable zoom" option:

allows the user to pinch zoom.
displays the zoom buttons.

To play HTML 5 videos in an HTML Display control:

Check "Allow execution of scripts" ("General" tab in the control description window).
Enable the device acceleration on the window. To do so, you must edit the manifest of the application.
- In the generation wizard, go to the "Configuration" step.
- Click "Advanced configuration".
- Click "Edit manifest".
- Expand the "application" node.
- Select the "activity" node corresponding to the window containing the HTML control.
- Add an attribute to this node while specifying "android:hardwareAccelerated" as name and "true" as value.
- Confirm changes
- Finish the wizard.

Related Examples:

Complete examples (WINDEV): WD Simple Internet Browser

[ + ] This example presents the features of WINDEV's HTML control and includes a simplified web browser with browsing history, favorites, etc.

Complete examples (WINDEV): WD Mail

[ + ] This application is an email client developed in WINDEV. It is based on the Email objects.
This email client is used to retrieve and send emails by using the POP, IMAP and SMTP protocols.
You have the ability to apply filters to the incoming emails.

The application can also be used to manage several email accounts. The writing of an email is based on the HTML edit control.

Unit examples (WINDEV): HTML types (HTMLDocument, HTMLNode, HTMLAttribute)

[ + ] This example shows how to use the HTMLXxx WLanguage types (HTMLDocument, HTMLNode, HTMLAttribute)

Unit examples (WINDEV): The HTML control

[ + ] Using an HTML control