Grid General Tab

Properties in the Grid Configuration Dialog Box: General Tab 

Property

Description

Values

Name

Specifies a name for the grid that will identify the object when its parameters are linked to another object.

Any text or numbers.

Display Title
check box

Indicates whether to show the grid's title.

Selected – shows the title.

Cleared – hides the title. (Default)

Display Title
field

Specifies the grid's title. This field is available only when the Display Title check box is selected.

Any ASCII printable character.

Justification

Specifies the location of the title in the grid. This field is available only when the Display Title check box is selected.

Top – Left Justified

Top – Center Justified

Top – Right Justified

Bottom – Left Justified

Bottom – Center Justified

Bottom – Right Justified

Title Text
button

Specifies the color of the grid's title text.

Select a color from the color palette.

Modifiable

Indicates whether users can change the grid's configuration from the run-time environment.

Selected – users can change the configuration.

Cleared – users cannot change the configuration. (Default)

Autosize
Column Widths

Indicates whether to resize each column automatically based on the data received.

Selected – column widths autosize. (Default)

Cleared – column widths are static.

Show Grid
Lines

Indicates whether to show grid lines.

Selected – grid lines are visible. (Default)

Cleared – grid lines are hidden.

Show Status
Bar

Indicates whether to show the status bar below the grid that displays the number of rows received and the Refresh button.

Selected – status bar is shown. (Default)

Cleared – status bar is hidden.

Autosize to fit
Number of Rows

Indicates whether to limit the number of rows displayed. The valid range is 1 to 999.

Selected – the number of rows shown in the grid is limited to the number entered. If more rows are returned than is specified, the user will have to use the scroll bars or pagination to see them.

Cleared – the number of rows shown in the grid depends on the data and the default size of the grid object. (Default)

Enable Auto
Refresh

Indicates whether to enable an automatic refresh of the data every 1 or more seconds.

Selected – data is refreshed automatically every 1 or more seconds (as you specify).

Cleared – data is not refreshed when the display is opened. (Default)

Display Column
Header

Indicates whether to show the headings of each column.

Selected – shows the headers. (Default)

Cleared – hides the headers.

Display Row
Header

Indicates whether to show the headings of each row.

Selected – shows the headers. (Default)

Cleared – hides the headers.

Enable Sorting

Indicates whether to enable sorting by columns.

Selected – allows the user to sort the data by clicking the column header.

Cleared – sorting is disabled. (Default)

Enable Alternating
Row Color

Indicates whether to show alternating rows in a different color.

Selected – show alternating rows in the selected color (select a color from the color palette). (Default)

Cleared – show all rows in the default color.

Background
button

The background color for the grid

Select any color from the color palette. You can also select any named color defined.

Display Mode
option buttons

Specifies how to navigate through the grid at run-time.

Scrolling – navigate using the grid's scroll bar.

Pagination – display pagination controls.   (Default)

These controls include:

  • Previous and Next page buttons to browse forward and backward through the grid one page at a time.

  • First and Last buttons to quickly move to the start or end of the grid.

  • Page Number field to jump to a specific page of data in the grid.

Fill Direction
option buttons

Specifies how the grid fills with data.

Vertical – Columns appear as columns in the grid. Rows are numbered starting with 1. (Default)

Horizontal – Columns appear as rows in the grid. Columns are numbered starting with 1.

Column/Row
Header Color
buttons

Specifies the color settings for grid headers.

Text – the color of the text in the grid headers.

Background – the background color of the row and column headers.

Select a color from the color palette.