2. Row types
TreeGrid rows by kind and by position
- See Row basics documentation.
-
Rows by position
There are three row types in TreeGrid according to the position and structure:
-
Variable rows
(Scrollable, Body section)
- Contain cells in columns. Cells can be spanned in both directions, similarly to HTML <TABLE> tag. Cells can be spanned vertically only within root row page, horizontally in column page and column section.
- Only variable rows can be: scrolled vertically, nested in tree, sorted, filtered, grouped, paged, added, deleted, moved (dragged) inside the Body section
- Can contain only data rows, not feature rows.
- Defined as
<I>
tags inside <Body><B> ... </B></Body>
tags.
The <B></B> is a page. Only grid using server paging can contain more pages in data, all other grids have all rows in one page.
-
Fixed rows
(Frozen, Head and Foot section)
- Contain cells in columns. Cells can be spanned in both directions, similarly to HTML <TABLE> tag. Cells can be spanned vertically only within the section (Head or Foot), horizontally in column page and column section.
- Can contain data rows and these feature rows: <Header/> and <Filter/>
- Defined as
<I>
(or <Header/> or <Filter/>) tags inside <Head> ... </Head>
(above variable rows) and <Foot> ... </Foot>
(below variable rows) tags.
- There is one predefined fixed row <Header id='Header'/> as main header containing column captions. It is defined by
<Header/>
tag placed directly in <Grid> tag.
-
Solid space rows
(Floating, Solid sections between other section)
- Define their own cells (in Cells array) not related to TreeGrid columns. Every Space row can have different cells (their names, widths and other attributes like Type and Format).
The cells cannot be spanned in any direction.
- Can contain data rows (but with their own cells!) and these feature rows: <Toolbar/>, <Group/>, <Search/> and <Tabber/>
- Defined as
<I>
(or <Toolbar/> or <Group/> or <Search/> or <Tabber/>) tags inside <Solid> ... <Solid>
tag.
- Place in grid is set by their Space attribute (-1 above grid, 0 above Head, 1 between Head and Body, 2 between Body and Foot, 3 between Foot and scrollbar, 4 below scrollbar, 5 below grid.
- Place outside grid is set by Tag attribute.
- There is one predefined solid row <Toolbar id='Toolbar'/> as main toolbar containing basic TreeGrid buttons. It is defined by
<Toolbar/>
tag placed directly in <Grid> tag.
- To place some cells to right edge or to fill the rest of the row by cell(s), set the cell RelWidth attribute.
- See Solid space rows documentation.
Rows by kind
Data rows
- Data rows are base TreeGrid rows with data. They are expected to load their cells data from server and optionally upload the changes back.
- Can be used in all three rows section (Variable, Fixed and Solid). Only data rows can be placed in Variable section.
Feature rows
Feature rows to control particular TreeGrid feature. Every special row can be placed in grid more times.
The feature rows values are usually saved to cookies and not uploaded to server, although uploading to server is also possible.
All the Solid feature rows can be defined also by normal Space rows with cells - to merge functionality of more feature rows in one row (e.g. show grouping and search settings on toolbar).
- Header row defined by <Header> tag. Can be placed only in Fixed rows. Shows column captions. Provides column resizing and moving. Controls sorting settings.
Header row has cells like any data row, it is possible to define Type, Format and other cell attributes like <Header Col1='Column <b>1</b>' Col1Type='Html'/>.
The Header cells are not editable, but can be changed from popup list like Defaults. The default cell Type for Header row is Lines, new line can be added by '
' or can be retyped to Html and used <br>.
- Filter row defined by <Filter> tag. Can be placed only in Fixed rows. Controls filter settings. See Filter row documentation.
- Group row defined by <Group> tag. Can be placed only in Solid rows. Controls grouping settings. See Group row documentation.
- Search row defined by <Search> tag. Can be placed only in Solid rows. Controls search settings. See Search row documentation.
- Toolbar row defined by <Toolbar> tag. Can be placed only in Solid rows. Shows control image buttons. Nearly normal Space row with predefined type of new cells and different look. See Toolbar kind row documentation.
- Topbar row defined by <Topbar> tag. Can be placed only in Solid rows. Shows control image buttons. Just different look than Toolbar. See Topbar kind row documentation.
- Tabber row defined by <Tabber> tag. Can be placed only in Solid rows. Shows control tabs buttons. Nearly normal Space row with predefined type of new cells and different look. See Tabber kind row documentation.