Space rows

TreeGrid documentation

Space rows have all row and cell attributes as normal grid rows.

Solid space rows are especially used for toolbars, tabbers, functional rows like Group or Search or any custom control rows.
Space row is not divided to column sections, is still visible and never scrolled.
Space row cannot be sorted, filtered, selected, deleted, added or dragged, cannot have child rows, cannot be exported to Excel.
By space rows are done special rows Group, Search, Toolbar and Tabber.

Space row can be placed in <Solid> tag as the <I> or <Space> tag.
It is placed into table between other rows sections (Head / Body / Foot) or above or below table, the position is set by Space attribute.
It can be placed also outside grid by Tag attribute.

Every space row can have its own named cells defined by Cells array. The names of cells can, but don't need to be the same as column names.
The space cells are not related to grid columns, every cell have its width set by its Width attribute. The cells cannot be spanned.
The space cell attributes never read its value from grid column, even if they are named same. The space cells are not affected by any grid column resize or move.

Space row can be hidden and displayed by Visible attribute or by ShowRow / HideRow API methods.
Can be calculated, the Formula must be set for individual cells. Can run after cell change or button type cell click. Cells can be focused and/or edited.
Comma separated list of cells in the row. The names of cells can, but don't need to be the same as column names.
These cells are not related to grid columns, even if they have the same names.
Every cell have its width set by its Width attribute, so the cells are not aligned with grid columns. The cells cannot be spanned.
If the space row contains many cells, it is possible to split their definition to more CellsXXX arrays.
The XXX can be any alphanumeric string. The final Cells order is done by sorting the CellsXXX by the XXX, always as strings.
For API the cells are all always placed in the Cells array.
It is not possible to use both Cells and CellsXXX attributes in one row.
For example definitions <I Cells5="A,B" Cells06="C,D" Cell10Test="E,F,G" Cells100C="H" CellsB="I,J" Cellsaaa="K"/> and <I Cells="C,D,H,E,F,G,A,B,I,J,K"/> are the same.
Position of the row inside grid, specifies horizontal section of the grid.
If more solid rows has the same Space value, they are placed in the order they are in XML.
-1 - above table, 0 - above Head, 1 - between Head and Body, 2 - between Body and Foot, 3 - between Foot and vertical scrollbar, 4 - under vertical scrollbar, 5 - under table
-1, 0, 4, 5 are spanned for whole grid, including vertical scrollbar and pager,
1, 2, 3 are spanned only for columns - the vertical scrollbar and pager are placed right side.
To place Space row outside the grid to any HTML tag on page. If set, the Space attribute is ignored.
It is the id of HTML tag where to render the row.
The width of the external space row is still preserved to be the same as the actual main table width.
In trial version this attribute is ignored.
Kind of the space row, can be set also by tag name, e.g <Space Kind='Test' ... /> is the same as <Test ... />
There are special kinds of space rows: Group, Search, Toolbar, Toolbar1, Toolbar2, Toolbar3, Topbar, Topbar1, Topbar2, Topbar3, Tabber, Tabber2 (since 10.0), Fill (empty row created for ConstHeight) with special features, NoData (row shown on empty grid).
By the custom Kind settings you can set CSS class for the whole row, the CSS class name will be Tx + kind + Row, e.g. TSTestRow.
If set, copies all not defined attributes in actual space row from the Mirror space row. The Mirror is the row id.
Use especially to split toolbar with many cells to more rows for different media rule - mirror the original toolbar, hide it and hide particular cells in the destination toolbars.
It should be used instead of default row (Def attribute), because the default space row cannot define cells.
Mirror can be nested, one row can mirror another row that already mirrors another row.
If the row displays (disabled) left panel, just for the same look as other rows.
If set to 2, it displays the panel even if the whole panel column is hidden.
HTML label displayed in front of the cell.
Inserts new cell Type='Html' CanFocus='0' Width='-1' in front of the cell.
HTML label displayed after the cell.
Inserts new cell Type='Html' CanFocus='0' Width='-1' after the cell.
Left indent of any cell, in pixels.
Inserts new cell Type='Html' CanFocus='0' Width='Label width' in front of the cell.
Set it to 1 to resize the cell to whole rest of the space row.
Or to have previous cells aligned to left edge and next cells aligned to right edge of the row.
If set to 1 it wraps row cells to more lines if there is not enough room to display them horizontally in one line.