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

RWA_HIDDEN (RealWeb) (rwa_hidden.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

RWA_HIDDEN

Purpose

Creates a hidden field for a form and appends it to a string.

Hidden fields are always included in the submitted form's parameter list. They cannot be amended by the browser or user. Hidden fields can be used to label a form so that a routine responsible for processing many different forms can easily identify an individual form or form version (see Example 1).

Another use for hidden fields is to manage user/server interactions, allowing the server to link several forms submitted by one user. For example, the first form submitted by the user may have requested some basic information, such as name and address. Based on that initial contact, the server might create a second form asking more specific questions of the user. Since it is tedious for the user to re-enter the name and address details, the server can be programmed to put those values into the second form in hidden fields (see Example 2).

Syntax

RWA_HIDDEN(String, Name, Value, Class)

Parameters

String Name of the string to which the code for the hidden field is to be appended.

Name Name of the hidden field.

Value Specifies the value of the hidden field.

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.