Common section properties

Many of the properties of a section are the same regardless of the form type. This section discusses these common properties. The information is not repeated in other parts of this user guide except to highlight a difference from the common property or to add additional information.
Type
The type of section this will be. Select the value from the drop-down list: Form Section, Smart Section, Multi Tab Section, Query Section, Report Section, Graphics Section, Excel Section, Gantt Section, Availability Legacy Section, Stacking Section, Group By Section, Calendar Section, or Availability Section.
Name
The value of this property is the name that workflows use to identify the section. It must be unique within the tab that contains it.
Label
The value of this property is the text that will appear in the title bar on the section.
Height

The number that is the value of this property determines the height of the area used to display the section. The height is measured in lines of text. This sets the boundary in which an overflow of data causes scroll bars to appear.

The default value is 0 (zero), which translates to an initial display of 10 rows of data with a height of 23 pixels for each row.

Title Bar Color

This property usually does not have a value. If this property does not have a value, the background color of the title bar for this section will be the default color specified in the Style Manager.

To specify a color, click the search icon. A palette of colors will pop up. After you have selected a color by clicking it, the color palette disappears and a rectangle of the selected color appears. The Advanced color picker also is available. See Color fields for its usage.

Clicking the X icon causes the color selection to be cleared, so that the default color will be used for the title bar.

Visible

If this property's check box is checked, this section will be visible. If the check box is not checked, this section will be hidden. The default for this property is for the check box to be checked.

Workflows can change the value of this property at runtime, making the section visible or hidden as appropriate.

Expand Section
This is checked by default. If this check box is checked, the first time a user uses this form, this section will be expanded by default. If not checked, the section will be collapsed by default. Note that for subsequent use of this form, IBM® Maximo® Real Estate and Facilities remembers the state of each section for each user.
Read Only
If this check box is checked, all fields in this section will be read-only. People will not be allowed to modify the contents of the fields using the form or to drag or resize events.
Show Title Bar

This check box is usually checked. If this check box is checked, a title bar will be displayed. If the check box is not checked, no title bar will be displayed.

A common reason to leave this check box unchecked is so that what is internally organized as two sections appears to be one section.

Border Size
The number that is the value of this property determines the width of the border around this section.
Border Color

If this property does not have a value, the border around this section is the default color specified in the Style Manager.

To specify a color, click the search icon. A palette of colors will pop up. After you have selected a color by clicking it, the color palette disappears and a rectangle of the selected color appears. The Advanced color picker also is available. See Color fields for its usage.

Clicking the X icon causes the color selection to be cleared, so that the default color will be used for the title bar.

Style Class

If you do not specify a value for this property, the appearance of this section will be determined by default settings in the Style Manager.

If you do specify a value for this property, it will be the name of a section style sheet defined by the Style Sheet Editor. The style sheet determines the appearance of the label. The Style Sheet Editor is described in the IBM Maximo Real Estate and Facilities: User Experience User Guide.

Start Row

The value of the Start Row property specifies in which of the tab's rows this section will appear. The rows in tabs are counted from the top to the bottom, so row 1 is above row 2. If a section is more than one row tall, this property specifies in which row of the tab the top of the section will appear.

The platform uses the absolute value of the number entered.

Row Span
This property specifies the height of the section in rows. For most sections, the Row Span value is 1.
The Start Column and Col Span properties determine a section's horizontal position and width within its tab. A tab is laid out in twelve columns. Most tabs do not look like they are laid out in twelve columns because they do not use all twelve columns. If a tab has no sections in a column, the column has no width and it looks like the column is not there. The following figure is a visual explanation of how the values of the Start Row, Row Span, Start Column and Col Span properties combine to determine a section's size and position within a tab.
Figure 1. Start Row, Row Span, Start Column, and Column Span combinations
The image is explained in the text.