AX1516

Setting the theme for a Formatted Grid (deprecated)

IMPORTANT: Themes only apply to legacy skins. If your form uses the default Axiom2018 skin introduced in version 2018.1, themes do not apply.

Formatted Grid components depend on a specified theme to determine general formatting properties for the grid, as well as to determine which row and column styles are available to be used in the data source.

By default, the Formatted Grid component inherits the form-level theme, just like all other components in the form. However, while other components may render just fine if the form does not have a specified theme, formatted grids almost always require a theme. Therefore, you should always make sure to specify a form-level theme if the form contains a formatted grid. To do so, click Edit Form Properties in the Form Designer or Form Assistant, and then use the Theme property to assign a theme. For more information on specifying the theme for a form, see Setting the theme for an Axiom form (deprecated).

Because formatted grids are very dependent on the theme, it is possible that you may want to use different themes for multiple grids in the same form. For example, you may have a form where you want one grid to use the Report theme and the other grid to use the Worksheet theme. Whichever theme is best suited for the overall form contents should be set at the form level, and the grids will inherit that theme by default. For the grid that you want to use a different theme, you can override the form theme at the component level by using the Component Theme property in the advanced component settings (click Show Advanced Settings under the Style box). The Component Theme property is available for all components, but it is most likely to be used on Formatted Grid components.

For grids, some of the differences between themes include:

  • The Wizard theme and Worksheet theme have more row padding, to account for spacing between multiple rows of input controls.
  • The Report and Grouped Report themes have less row padding, to allow displaying many rows of data on a single page.
  • The Report and Grouped Report themes provide row and column styles for typical report designs, such as column headers, and total and subtotal rows.
  • The Grouped Report theme provides additional row and column styles to display multiple levels of headings (groupings) in a single report.