HTMLCONTROL

10.0A, PLBCMP GUI Only

The HTMLCONTROL object is a container which can be populated with HTML elements. The HTMLCONTROL object can exist and be used in programs executed by the runtimes PLBWIN, PLBNET, PLBSERVE, and PLBWEBSRV. To define a HTMLCONTROL, use one of the following statement formats:

(1)	[label]	HTMLCONTROL	[%]
(2)	[label]	HTMLCONTROL	(arraysize)
(3)	[label]	HTMLCONTROL	^
(4)	[label]	HTMLCONTROL	^,{target}
(5)	[label]	HTMLCONTROL	^(arraysize)
(6)	[label]	HTMLCONTROL	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

The HTMLCONTROL object is a specialized container that can be populated with HTML elements. The HTML elements are defined in the InnerHtml property data stream which can be simple HTML elements or a complex web page with supporting JavaScript, CSS, and HTML objects.
When HTML elements are created in a HTMLCONTROL, they are enabled, disabled, hidden, made visible, or destroyed when one of these actions take place on the HTMLCONTROL.
Multi-dimension arrays are supported to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a HTMLCONTROL may be defined as Global, it is DESTROYed during a CHAIN instruction.
When a HTMLCONTROL is created using a PL/B Web Server runtime, the HTML elements are rendered by the client browser like other PL/B GUI objects.
When a HTMLCONTROL is created using a Windows runtime including PLBWIN, PLBNET, or PLBSERVE, the HTMLCONTROL, it is created using the Windows 'IWebBrowser2' interface for the Windows PL/B runtimes.