Web DataWindow properties

This section describes the XML, XHTML, and HTML DataWindow object properties for the Web DataWindow. You can set these properties in the DataWindow painter or in script.

For more detailed information about each property, see the DataWindow Reference or the online Help for the property name. For information about how to set properties in the DataWindow painter, including shared HTML and XHTML properties, see “Setting Web generation properties for the Web DataWindow”.

XML and XHTML data properties

Table 6-4 shows row data properties for the XML and XHTML Web DataWindow.

Table 6-4: Row properties for the XML and XHTML Web DataWindow

Property

User interface fields

Description

Data.XHTML

Read only, so no user interface field

A string containing the row data content of the DataWindow object in XHTML format

Data.XMLWeb

Read only, so no user interface field

A string containing browser-specific JavaScript that performs the XSLT transformation on the browser

XML Web DataWindow generation properties

Table 6-5 lists properties supporting XML Web DataWindow generation.

Table 6-5: Properties supporting XML Web DataWindow generation

Property

User interface fields

Allows you to

CSSGen.property

Web Generation property page with CSS selected as the format to configure: resource base and publish path

Specify the physical path to which a generated CSS style sheet is published and the URL indicating the location of the style sheet where the property variable is PublishPath or ResourceBase.

JSGen.property

JavaScript Generation property page with XHTML selected as the format to configure: resource base and publish path

Specify the physical path to which generated JavaScript (that is included in the final XHTML page) is published and the URL indicating the location of the generated JavaScript where the property variable is PublishPath or ResourceBase.

XMLGen.property

Web Generation property page with XML selected as the format to configure: resource base and publish path

Specify the physical path to which XML is published and the URL referenced by the JavaScript that transforms the XML to XHTML where the property variable is PublishPath or ResourceBase. You can also specify whether XML is generated inline to the XSLT transformation script and whether paging is performed on the client or server.

XSLTGen.property

Web Generation property page with XSLT selected as the format to configure: resource base and publish path

Specify the physical path to which the generated XSLT style sheet is published and the URL referenced by the JavaScript that transforms the XML to XHTML (using the generated XSLT stylesheet) where the property variable is PublishPath or ResourceBase.

XHTMLGen.Browser

Web Generation property page with XHTML selected as the format to configure: browser

Identify the browser in which XHTML generated within an XSLT style sheet is displayed.

NoteAbout PublishPath and ResourceBase PublishPath is a string that specifies the physical path of the Web site folder to which PowerBuilder publishes generated CSS, JavaScript, XML, or XSLT. ResourceBase is a string that specifies the URL of the generated file.

HTML properties

There are four types of HTML properties you can set in the DataWindow painter. The first three apply to the DataWindow object itself. The last applies to bitmap, column, computed field, and text controls in the DataWindow object.

NoteSome properties are now shared but property names are unchanged In previous versions of PowerBuilder, HTML properties applied only to the HTML Web DataWindow. Now some HTML properties are shared with the XML Web DataWindow and the XHTML Web DataWindow. The HTML property names have not changed.

Table 6-6: HTML properties you can set in the DataWindow painter

Property

User interface fields

Allows you to

HTMLDW (shared)

Web DataWindow check box on the General page of the DataWindow object Property view. Selecting this check box sets this property to Yes.

View the HTML in a browser using Design>HTML Preview (or if you plan to use the DataWindow object with a custom Web DataWindow server component). The generic server component automatically sets this property to Yes.

HTMLTable.property (HTML only)

All fields on the HTML Table page of the DataWindow object Property view.

Change the display characteristics of HTML tables, including border style and cell width and padding.

HTMLGen.property (shared by all Web DataWindow formats)

All fields on the Web Generation page and the JavaScript Generation page of the DataWindow object Property view. (You can also start the JavaScript Generation wizard using the Generate File button on the JavaScript Generation page).

Control the number of rows displayed on the page, generate HTML for a specific browser or HTML version, choose client-side features to incorporate into the page, and set up JavaScript caching to enhance performance.

HTML.property (shared by all Web DataWindow formats)

All fields on the HTML page of the Property view for a Column, Computed Field, Text, or Picture control in a DataWindow object.

Set up hyperlinks and retrieval arguments typically used to create master/detail Web pages, specify whether the content of a control should be rendered as HTML, and specify any HTML to be appended to a control.