Using styles with the DataGrid component

You can set style properties to change the appearance of a DataGrid component. The DataGrid component inherits styles from the List component. (See Using styles with the List component.) The DataGrid component also supports the following styles:

Style

Theme

Description

backgroundColor

Both

The background color, which can be set for the whole grid or for each column.

backgroundDisabledColor

Both

The background color when the component's enabled property is set to "false". The default value is 0xDDDDDD (medium gray).

borderStyle

Both

The DataGrid component uses a RectBorder instance as its border and responds to the styles defined on that class. See RectBorder class.

The default border style value is "inset".

headerColor

Both

The color of the column headers. The default value is 0xEAEAEA (light gray)

headerStyle

Both

A CSS style declaration for the column header that can be applied to a grid or column to customize the header styles.

color

Both

The text color. The default value is 0x0B333C for the Halo theme and blank for the Sample theme.

disabledColor

Both

The color for text when the component is disabled. The default color is 0x848384 (dark gray).

embedFonts

Both

A Boolean value that indicates whether the font specified in fontFamily is an embedded font. This style must be set to true if fontFamily refers to an embedded font. For example (using a DataGrid instance my_dg):

my_dg.setStyle("fontFamily", "yourFont");

my_dg.embedFonts=true;

Otherwise, the embedded font is not used. If this style is set to true and fontFamily does not refer to an embedded font, no text is displayed. The default value is false.

fontFamily

Both

The font name for text. The default value is "_sans".

fontSize

Both

The point size for the font. The default value is 10.

fontStyle

Both

The font style: either "normal" or "italic". The default value is "normal".

fontWeight

Both

The font weight: either "none" or "bold". The default value is "none". All components can also accept the value "normal" in place of "none" during a setStyle() call, but subsequent calls to getStyle() return "none".

textAlign

Both

The text alignment: either "left", "right", or "center". The default value is "left".

textDecoration

Both

The text decoration: either "none" or "underline". The default value is "none".

vGridLines

Both

A Boolean value that indicates whether to show vertical grid lines (true) or not (false). The default value is true.

hGridLines

Both

A Boolean value that indicates whether to show horizontal grid lines (true) or not (false). The default value is false.

vGridLineColor

Both

The color of the vertical grid lines. The default value is 0x666666 (medium gray).

hGridLineColor

Both

The color of the horizontal grid lines. The default value is 0x666666 (medium gray).