Form Layout: Grid Presets
To configure the appearance of a grid, you can specify a preset for the grid. A preset is a
predefined set of properties, such as mergeToolbarWidth
or
syncPosition
, that define the appearance of the grid.
Presets are an analog of the SkinID
property in ASPX. However, not all
values of the SkinID
property have analogs in the Modern UI.
You need to find the appropriate preset in the list of available values.
You should use presets because they unify the appearance of grids in the UI and simplify the process of updating the design.
To specify the preset, use the preset property of the gridConfig
decorator, as shown in the following example.
Without Preset | With Preset |
---|---|
|
|
Available Presets
The following table lists the values of the preset property and the designs they provide.
Value | Description |
---|---|
primary |
An editable grid. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX:
|
primaryInquiry |
A read-only grid. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX: |
inquiry |
A read-only grid. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX: |
details |
An editable grid. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX: |
attributes |
A partially editable grid with a predefined set of lines, but the cells can be editable. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX: |
shortList |
An editable grid. The preset includes the following settings:
Guidelines:
Respective SkinID in ASPX: |
empty |
An empty preset that includes no settings. Guideline: Use this preset if the preset property becomes mandatory and you need to use a custom set of properties. |
The default values of each preset are described in the following table.
Property | empty | primary | primaryInquiry | inquiry | details | attributes | shortList |
---|---|---|---|---|---|---|---|
graph | - | - | - | - | - | - | - |
view | - | - | - | - | - | - | - |
screenId | - | - | - | - | - | - | - |
dataField | - | - | - | - | - | - | - |
gridDataUrl | - | - | - | - | - | - | - |
pagerMode | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast | GridPagerMode.NextPrevFirstLast |
pageSize | 100 | 100 | 100 | 100 | 100 | 0 | 0 |
adjustPageSize | false | true | true | false | false | false | false |
parameters | - | - | - | - | - | - | - |
syncPosition | false | true | true | false | true | false | false |
suppressNoteFiles | false | false | false | false | false | false | false |
preserveSortsAndFilters | false | true | true | false | false | false | false |
autoAdjustColumns | false | false | false | false | true | false | true |
generateColumns | GridColumnGeneration.None | GridColumnGeneration.None | GridColumnGeneration.None | GridColumnGeneration.None | GridColumnGeneration.None | GridColumnGeneration.None | GridColumnGeneration.None |
generateColumnsAfterSelect | false | false | false | false | false | false | false |
generateProcessColumns | false | false | false | false | false | false | false |
columns | - | - | - | - | - | - | - |
columnsConfig.type | GridColumnType.NotSet | GridColumnType.NotSet | GridColumnType.NotSet | GridColumnType.NotSet | GridColumnType.NotSet | GridColumnType.NotSet | GridColumnType.NotSet |
columnsConfig.textAlign | TextAlign.NotSet | TextAlign.NotSet | TextAlign.NotSet | TextAlign.NotSet | TextAlign.NotSet | TextAlign.NotSet | TextAlign.NotSet |
columnsConfig.allowNull | true | true | true | true | true | true | true |
columnsConfig.allowUpdate | true | true | true | true | true | true | true |
columnsConfig.allowFilter | true | true | true | true | true | true | true |
columnsConfig.allowFocus | true | true | true | true | true | true | true |
columnsConfig.allowSort | true | true | true | true | true | true | true |
columnsConfig.allowResize | true | true | true | true | true | true | true |
columnsConfig.visible | true | true | true | true | true | true | true |
columnsConfig.allowShowHide | GridColumnShowHideMode.True | GridColumnShowHideMode.True | GridColumnShowHideMode.True | GridColumnShowHideMode.True | GridColumnShowHideMode.True | GridColumnShowHideMode.True | GridColumnShowHideMode.True |
columnsConfig.displayMode | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value | GridColumnDisplayMode.Value |
autoSaveLayout | true | true | true | true | true | false | false |
allowSkipTabs | true | true | false | false | true | true | true |
allowStoredFilters | false | false | false | false | false | false | false |
quickFilterFields | - | - | - | - | - | - | - |
filterView | - | - | - | - | - | - | - |
filterRowsView | - | - | - | - | - | - | - |
fastFilterId | - | - | - | - | - | - | - |
fastFilterByAllFields | true | true | true | true | true | false | false |
showRowSelectors | true | true | true | true | true | true | true |
showFilterBar | true | true | true | true | true | true | true |
showTopBar | true | true | true | true | true | false | true |
showBottomBar | true | true | true | true | true | false | false |
topBarItems | - | - | - | - | - | - | - |
actionsConfig | - | - |
|
|
- | - |
|
mergeToolbarWith | - | 'ScreenToolbar' | 'ScreenToolbar' | - | - | - | - |
wrapToolbarWith | - | - | - | - | - | - | - |
wrapToolbar | false | false | false | false | true | false | false |
statusField | - | - | - | - | - | - | - |
defaultAction | - | - | - | - | - | - | - |
exportRowsLimit | - | - | - | - | - | - | - |
batchUpdate | false | false | false | false | false | false | false |
initNewRow | false | false | false | false | false | false | false |
allowUpdate | from server | from server | from server | from server | from server | from server | from server |
allowDelete | from server | from server | false | false | from server | false | from server |
allowInsert | from server | from server | false | false | from server | false | from server |
allowImport | from server | from server | false | false | from server | false | false |
allowFilter | true | true | true | true | true | false | false |
allowSort | true | true | true | true | true | false | true |
autoRepaint | - | - | - | - | - | - | - |
caption | - | - | - | - | - | - | - |