Manipulating an HTML Display control in the code

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

HTML Display control

Manipulating an HTML Display control in the code

Overview

Manipulating an HTML Display control in the code

Associated WLanguage properties

See also

The HTML Display control

Manipulating an HTML Display control in the code

Overview

The HTML Display control is used to display a Web page in an application. Thus, in 1 line of code, without using an external browser, your WINDEV applications can display a page of a website.

The HTML Display control can be manipulated directly in the code. Simply use the HTML Display control variable. The HTML Display control variable is 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 manipulate an HTML Display control in the code.

Manipulating an HTML Display control in the code

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

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 the 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)
RESULT 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:


Body	The Body property is used to identify and modify the HTML body of an HTML Display control or an HTML Editor control.
Document	The Document property is used to identify or modify the HTML document associated with an HTML Display control or an HTML Editor control.
SecurityHtml	The SecurityHtml property is used to get and change the status of the security mechanism of HTML Display and HTML Editor controls.
URL	The 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 an HTML Display control, see Properties associated with HTML Display controls.