Rendering HTML for controls in an HTML Web DataWindow

This section applies to the HTML Web DataWindow only. XML
Web DataWindow and XHTML Web DataWindow features supersede the need
to perform any of the following actions.
Including HTML in a control
You can include valid HTML in some controls in a DataWindow
object, including a text control, column, or computed field. To
render the contents of the control as HTML when the HTML for the
DataWindow is generated, set the control’s ValueIsHTML
property to TRUE. For example, suppose a text control’s
text property is <I>Name</I>.
The following table shows how the text is rendered in the generated
HTML and displayed in a browser.
ValueIsHTML |
Generated HTML source |
Output in browser |
---|---|---|
TRUE |
<I>Name</I> |
Name |
FALSE |
<I>Name</I> |
<I>Name</I> |

The HTML Generator does not validate the HTML you include
in controls in DataWindow objects. If the HTML is not valid, the
DataWindow might not display correctly.
Appending HTML to a control
The AppendedHTML property enables you to append your own HTML
to the HTML generated by the HTML Generator component. You can use
this feature to specify attributes and event actions. The HTML you
specify for the AppendedHTML property value is appended to generated
syntax for the rendering of a DataWindow control before the closing
bracket of the HTML element for that control.

The HTML Generator does not validate the HTML you append to
controls in DataWindow objects. If the HTML is not valid, the DataWindow
might not display correctly.
You must also make sure not to use an event handler name that
is already generated for a DataWindow control as a client-side event
handler. These include the event handlers in Table 6-9.
DataWindow control |
Generated event handler |
---|---|
Edit, EditMask, DropDownListBox, or DropDownDataWindow |
onFocus, onClick, onChange, and onBlur |
CheckBox or RadioButton |
onFocus, onClick, and onBlur |
TextBox, Picture with link, or Button |
onClick |