ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / HTML Display control
  • Overview
  • Manipulating HTML Display controls programmatically
  • Displaying information in an HTML Display control
  • Getting the value of an HTML Display control
  • Preventing the user from using a link in a page
  • Associated WLanguage properties
  • Properties specific to HTML Display controls
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Manipulating HTML Display controls programmatically
Overview
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.
The HTML Display control can be manipulated directly in the code. To do so, use the variable of the HTML Display control in the code. This variable corresponds to the name of the HTML Display control. The variable type is a character string.
You can also manipulate HTML Display controls in the code using HTML Display control functions.
This help page explains how to programmatically manipulate HTML Display controls.
Manipulating HTML Display controls programmatically

Displaying information in an HTML Display control

To display information in an HTML Display control, simply assign a value
For example:
  • Direct assignment:
    HTM_WebPage = "http://www.windev.com"
  • Assignment using a variable:
    HTM_WebPage = MyPage
You can also use the Value or URL properties.

Getting the value of an HTML Display control

To get the content of an HTML Display control (the user can use the links in the page displayed in the control):
  • Simply assign a value. For example:
    HTMLContent = HTM_HTMLDisplayControl
  • Use the Value property.
Note: To get the source code of the page displayed in the HTML Display control, simply use the DisplayedValue property on the control:
Info(HTM_WebPage.DisplayedValue)

Preventing the user from using a link in a page

By default, in the HTML Display control, the user can use the various links in the page displayed in the control.
To limit the use of these links, you can use the "Before loading HTML page" event.
For the following example, let's assume that the list of authorized sites is contained in a WLanguage array.
PROCEDURE ChangePage(sURL is string, sDestination is string)
ArrAuthorizedSites is array of 2 strings
ArrAuthorizedSites[1] = "windev.com"
ArrAuthorizedSites[2] = "google.com"
let sDomain = URLExtractPath(sURL, urlDomain)
IF ArraySeek(ArrAuthorizedSites, asLinearFirst, sDomain) = -1 THEN
		ToastDisplay("Unauthorized site", toastShort, vaMiddle)
		RETURN False
END
RETURN True
This code returns False if the site is not authorized and displays a toast.
Associated WLanguage properties

Properties specific to HTML Display controls

The following properties are used to manage the characteristics of an HTML Display control in the code:
BodyThe Body property gets and sets the HTML body of an HTML Display control or an HTML Editor control.
DocumentThe Document property is used to identify or modify the HTML document associated with an HTML Display control or an HTML Editor control.
SecurityHtmlThe SecurityHtml property gets and sets the status of the security mechanism of HTML Display and HTML Editor controls.
URLThe URL property is used to:
  • Get the address associated with a control.
  • Change the address associated with a control.
For a complete list of WLanguage properties that can be used with HTML Display controls, see HTML Display control properties.
Minimum version required
  • Version 26
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/11/2025

Send a report | Local help