Property Reference

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.