RWA_EDIT_BOX

Related Topics

Example

---

Purpose

Creates a text input field for a form, with the specified name and size. Output is appended to a string.

Syntax

RWA_EDIT_BOX(vString, Name, Size, aClass)

Parameters

vString A variable containing the string to which the edit box declaration will be appended. On return, the variable contains the modified string. If the string does not exist, it is created.

Name A name, unique within the form, for the text field.

Size The size, in characters, of the text field.

aClass A dynamic array A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  that can contain the following elements:

Element No.	Attribute	Description
1	CLASS	The name of a tag class defined in a CSS 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.
2	MAXLEN	The maximum capacity, in characters, of the edit box.
3	VALUE	Specifies the initial contents of the edit box.
4	SIZE	Specifies the visible width, in characters, of the edit box.
5		A Boolean A data type that can take only the values TRUE and FALSE. In RealWeb TRUE is defined as any non-zero integer, and FALSE as 0 or a null string. Any other values generate a run time error.  operator that, if 'true', sets the input as MASKED, that is, password mode.

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.