Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

RWS_LABEL (RealWeb) (rws_label.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

RWS_LABEL

Purpose

Adds a label to the contents of a string. The string should normally contain a form control - for example, an edit box created with RWA_EDIT_BOX. When the user clicks a label, the focus is passed to the associated form control.

Note: Labels are not fully supported in the current version of Internet Explorer (version 6) and are not supported at all in Netscape (version 6). This means that, though the label is displayed correctly, the focus is not passed to the associated form control when the label is clicked. The second example shows how you can obtain full label functionality in Internet Explorer.

Syntax

RWS_LABEL(vString, LabelText, aClass)

Parameters

vString A string variable containing the text to be tagged as a labelled item. On return, the variable contains the modified string.

LabelText The text to be used as a label for the item.

aClass A dynamic array that can contain the following elements:

Element No.	Attribute	Description
1	CLASS	The name of a tag class defined in a CSS stylesheet.

Attributes defined in the aClass parameter are applied to the INPUT tag.

For information about using aClass, see The aClass Parameter.

Dependencies

Requires a previous call to RW_START_HTML_FORM.