Themes and Visual Classes

Property

Description

Attributes

Auto Track

Controls the automatic tracking of the contents of a grid relative to movement of the scrollbars (vertical/horizontal).

By default, when a scrollbar position is changed by dragging the "thumb", the grid will not follow the movement until the thumb is released. This reduces the screen re-draw overhead within the system but does not allow the user to view the data during the scroll operation. This property controls whether the grid is to be updated while the thumb is being moved -- in effect having the grid contents track the thumb position.

Click the drop-down arrow for available selections:

(Auto Track property was added in PxPlus 2018.)

Borderless

Control has no border or frame.

Enter Mode

Defines how the ENTER key will be processed for the grid. Click the drop-down arrow for available selections:

(Enter Mode property was added in PxPlus 2018.)

Grid Auto Column Size

Controls the automatic adjustment of column sizes so that the total space occupied by the columns will fill the control width. Click the drop-down arrow for a list of available selections: As is, Off, On.

When this property is set to On, the system will adjust all columns in the control so that the sum of the column widths will completely fill the control width exclusive of any scrollbars that may be present. Once set, any resizing of the control will again re-apply the automatic columns sizing logic. When adjusting the column sizes, the system will compute the new size based on percentages.

Example:

Suppose that a grid has three columns: Column 1 is 40 pixels wide, Column 2 is 10 pixels wide, and Column 3 is 50 pixels wide.

If this grid has Auto Column Size enabled, it would determine that Column 1 was 40% of the total column width, Column 2 was 10%, and Column 3 was 50%. These columns would each be adjusted based on the total width of the control to retain the same percentages. Therefore, if the grid itself was 150 pixels wide, Column 1 would become 150*40%=60 pixels, Column 2 would become 150*10%=15 pixels, and Column 3 would become 150*50%=75 pixels.

Grid Auto Column Size property was added in PxPlus 2018.)

Grid Hide Buttons

Hides query buttons or drop box icons associated with grid cells if there is a bitmap (thus, the bitmap is all that shows on a transparent background).

(Grid Hide Buttons property was added in PxPlus 2020.)

Grid lines

Controls the display of lines for the grid. Click the drop-down arrow for available selections:

(Grid lines property was added in PxPlus 2018.)

Header Height

Controls the height of the grid header in pixels.

Setting this property to -1 restores the height to its default size. Setting this property to 0 results in no header.

(Header Height property was added in PxPlus 2020.)

Row Height

Number of lines high per row of grid. Valid values are >= 1. Allow for word-wrap. Can also be set to -1 to use the default row height for the grid.

(Row Height property was added in PxPlus 2020.)
(Support to allow a setting of -1 was added in PxPlus 2024.)

Suppress Header

Suppress grid headers. Possible values are:

Suppression is done by setting the header height/width to 0. When not suppressed, the height/width will return to the last value.

(Suppress Header property was added in PxPlus 2021.)

Tab Mode

Defines how the TAB key will be processed with the grid control. Click the drop-down arrow for available selections:

(Tab Mode property was added in PxPlus 2018.)

Colors

Click the dotted Query button or double click inside the cell to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.

After a color property is set, a tick in the selected color displays in the top left corner. A floating tip with a sample of the selected color displays when hovering the mouse over the color setting.

(The color tick and color tip were added in PxPlus 2018.)
(The Color Selections Query button and dialog were added in PxPlus 2020.)

Background

Background color of the control in its default state.

Button Color

Background color for system-generated buttons in a grid, including Drop Box buttons and Query buttons.

This property will also be applied to cells with the 'Lock property set to 1 only when creating a "Button" cell type, providing that the BackColor$ property has not been set specifically for that cell.

(Button Color property was added in PxPlus 2021.)

Current Cell Color

Background color for the current cell.

(Current Cell Color property was added in PxPlus 2018.)

Current Cell Text Color

Text color for current cell.

(Current Cell Text Color property was added in PxPlus 2024.)

Fill Color

Defines the color to be used to fill in the empty regions of a grid (blank space to the right and below the grid).

Foreground

Foreground text color of the control in its default state.

Foreground Button Color

Foreground text color for system-generated buttons in a grid, including drop box buttons and query buttons.

(Foreground Button Color property was added in PxPlus 2024.)

Grid Hilight Color 1

Background color - alternating rows. (Will not display if Background is set to a color other than Default.)

(Grid Hilight Color 1 property was added in PxPlus 2018.)

Grid Hilight Color 2

Background color - alternating three rows. (Will not display if Background is set to a color other than Default.)

(Grid Hilight Color 2 property was added in PxPlus 2018.)

Header Background Color

Background color for the top row only (row -1) and does not affect the leading left column (colno -1).

(Header Background Color property was added in PxPlus 2018.)

Header Text Color

Color of the text for the top row only (row -1) and does not affect the leading left column (colno -1).

(Header Text Color property was added in PxPlus 2018.)

Line Color

Color of the lines drawn between rows and columns.

(Line Color property was added in PxPlus 2020.)

Row Header Background Color

Background color for the leading left column only (colno -1) and does not affect the top row (row -1).

(Row Header Background Color property was added in PxPlus 2024.)

Row Header Text Color

Color of the text for the leading left column only (colno -1) and does not affect the top row (row -1).

(Row Header Text Color property was added in PxPlus 2024.)

Track Color

Header cells corresponding to a cell that currently has focus are switched to the color set by this property as the user moves around the grid. This provides a visual cue to the user for which column and row they are on currently. Only header cells that use their default color will change to the tracking color.

(Track Color property was added in PxPlus 2018.)

Colors (States)

Lock Background Color

Background color when the cell is locked.

(Lock Background Color property was added in PxPlus 2024.)

Lock Text Color

Foreground text color when the cell is locked.

(Lock Text Color property was added in PxPlus 2024.)

Font

Font

Click the dotted Query button or double click inside the cell to specify font properties and attributes such as Bold, Italics, etc.

Header Font

Defines the font for the top row only (row -1) and does not affect the leading left column (colno -1).

(Header Font property was added in PxPlus 2018.)

Other

iNomads Class

Assign an iNomads class to the control. The iNomads class contains class attribute references used when defining the control in the HTML code generated in iNomads. An iNomads class reference must start with an alpha character (A-Z or a-z), followed by any combination of A-Z, a-z, 0-9, underscore or dash. Multiple references may be entered, separated by a space.

For a list of pre-defined classes, see iNomads Classes.

(iNomads Class property was added in PxPlus 2020.)