|
Use this dialog to establish properties for a display component.
- Name -- Select a display property.
- Value -- Enter a value for the property. Enter None to establish a null value.
- Expression -- In lieu of an entered value, use an expression to calculate the property value.
Click Validate to check for errors. For information about using the XPRESS language,
see Configuration Reference III.
Display Properties
- align -- Aligns the element horizontally
on the form. Values are left, right, and center. This property is rarely used.
- allowedValues -- Establishes values for the list that displays in a select or multiselection
text box.
- autoSelect -- For the Select class only. When set to true, causes the first value in
the allowedValues list to be automatically selected if the initial value for the field
is null.
- availableTitle --
Specifies the title of the "available" box (part of a multiselection
box).
- color -- Specifies a field label color. Use standard HTML color formatting (#xxxxxx) to specify
the color value.
- colspan -- Deprecated. Allows a table cell to span multiple columns within a table.
- command -- Specifies the value of the command parameter posted when the user edits or selects this field.
- font -- Specifies the font style of a field label. The value must be one of the styles defined in the
styles/style.css file of the Lighthouse installation directory.
- helpKey -- Specifies guidance (field-level help) for the field. The value is the name of an entry
in an associated help ctalog specified by the form. Specifying a help key will cause an icon
to appear to the left of the field. Moving the mouse over this field causes text referenced in the
help catalog to display.
- isOrdered -- For the MultiSelect class only. If set to true, the MultiSelect is rendered
with additional buttons that allow you to move items up or down in the list.
- leftPad -- Specifies the number of spaces to insert to the left of a field label.
- location -- Use if the container defines more than one display area and the
component must be added to a specific area. Some containers allow the placement of
components to be controlled by assigning a value to the location property.
For example, the BorderedPanel container supports five different display areas:
north, south, east, west, and center. The recognized values for the location property
are defined by the container. If you do not assign a location, or assign a location
name that is not recognized, the container places the component in the default
location.
- maxLength -- Specifies the maximum length of the string that can be edited in the
text box.
- noNewrow -- If set to a value of true, the field displays on the
Lighthouse page next to the previous field. If not specified or set
to a value of false, the field appears on a new line, directly
beneath the previous field. This property is recognized only if the
field is contained in a form that uses the Editform display class.
- nowrap -- If set to a value of true, the generated
HTML uses the nowrap attribute.
- nullLabel -- Specifies the text that displays at the top of a
list box when no value is selected.
- onChange -- Similar to the command property. The value can be an arbitrary
Javascript statement to run when the field is modified. Not all components support the
onChange property. Use of this property is rare and requires detailed knowledge of the
generated HTML. If you use this property, the page must typically contain a Javascript
component that defines Javascript functions you call from within the onChange value.
- onClick -- When specified, the value is expected to contain Javascript that
will be assigned as the value of the onClick attribute of the input element generated
for this component. Not all components support the onClick property. Use of this property
is rare and requires detailed knowledge of the generated HTML. If you use this property,
the page must typically contain a Javascript component that defines Javascript functions
you call from within the onClick value.
- primaryKey -- This property is recognized only by the SortingTable container.
The SortingTable container organizes components into a table with each column expected to
contain components of the same class. SortingTable allows the rows to be sorted according
to the values in any column. Typically, the sort order is determined from the value of each
component in the column. There may be cases, however, where the value of the component is not
suitable for sorting or may be inefficient to compare. In these cases, you can specify an
alternate numeric sorting key.
- readOnly -- Displays read-only text. This text cannot be edited by the user.
You might use this property if, for example, you want to display resource attribute information
that an administrator needs to view when creating or editing user accounts.
- required -- If set to a value of true, indicates that the field is expected to
have a value before the form can be submitted. Required fields are normally marked with a red *
(asterisk).
- rightPad -- Specifies the number of spaces to insert to the right of a field label.
- secret -- Displays ***** (asterisks) in the place of entered text. This option is
most often used in password fields.
- selectedTitle -- Specifies the title of the "selected" box (part of a multiselection
box).
- size -- Specifies the width in characters of the text entry box. The box size is
recalculated depending on the length of the text in the box.
- title -- Defines the text that displays to the left of the field. The title also serves
as the default help key for the field. If the form specifies a help catalog, and the
field title matches an entry in that catalog, a help icon appears to the left of the
field title.
- value -- Sets the current value of the component. This value can be null to indicate
that there is no current value. Field values usually are not set with display properties;
they normally are assigned values automatically by the system.
- width -- Sets the width of the HTML component.
Click OK to save changes and close the property dialog.
|