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 CSSClosed Cascading Style Sheet - a mechanism by which the presentation of an HTML page can be separated from the content. A style sheet can be used to determine the appearance of one or more HTML pages.  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.