Description
A string containing HTML and JavaScript that represents data and presentation of the DataWindow object.
The data is presented in a read-only HTML table or data-entry form, depending on settings of other properties.
Obsolete property
Data.HTML is obsolete and should not be used, because the Web DataWindow technology is obsolete.
Applies to
DataWindows
Syntax
PowerBuilder dot notation:
dw_control.Object.DataWindow.Data.HTML
Describe argument:
"DataWindow.Data.HTML"
Usage
When HTMLDW is set to False, the value of Data.HTML is the same as the value of HTMLTable -- a read-only HTML table that displays all retrieved rows.
When the HTMLDW property is set to True, the value of Data.HTML is a form that supports data input with client scripts for data validation and events. The generated string for Data.HTML includes:
-
HTML input elements
-
JavaScript for validating newly entered data based on validation rules in the DataWindow object
-
HTML and JavaScript for navigation based on DataWindow Button controls with scrolling actions
-
State information about the modification status of data items
JavaScript for navigation passes the state of the DataWindow back to the page server in two variables: objectname_action and objectname_context. It also passes back any page parameters defined in the HTMLGen.SelfLinkArgs property. All the HTMLGen.property values affect the way HTML is generated.
The resulting Web DataWindow is a client-side control for a Web page with events and methods that can cooperate with a server component for a Web-based data entry application.
Exceptions
If the DataWindow is in print preview mode, or there are no columns with non-zero tab order, the setting of HTMLDW is ignored and the generated HTML is a read-only table, not a data-entry form.
To generate a simple form without data entry methodality, you can use the GenerateHTMLForm method.
Examples
strHtml = dw1.Object.DataWindow.Data.HTML
strHtml = dw1.Describe("DataWindow.Data.HTML")