Grid cursors - hover & focus
TreeGrid documentation
Specifies how the
actual (
hovered) row and cell and
focused row and cells will be highlighted.
<Cfg> int
Hover
[2] Saved to cookies, to not load it, set HoverLap='1'
What to hover under mouse cursor. It can be changed by a user from configuration menu.
0 - nothing,
1 - only cell color,
2 - full row and cell cursor
<Cfg> bool
ShowDrag
[1] Saved to cookies, to not load it, set ShowDragLap='1'
If shows dragged object under mouse cursor. The dragged row(s) or moved column(s).
It can be changed by a user in configuration menu.
new 6.0 chg 9.2 <Cfg> int
AbsoluteCursors
[5/0]
How the focus and hover cursors will be managed, bit array.
1.bit (&1) | If hover cursors are absolutely positioned |
2.bit (&2) | If focus cursors are absolutely positioned |
3.bit (&4) | If hover cursor does not display its row and cell border when hovering focus cursor. Useful when hover cursor is absolute and focus relative |
Relative (
0) - cursors are relatively positioned tags inside grid main tag.
Slower. It should
not cause any problems.
Absolute (
1) - cursors are absolutely positioned tags inside document body.
Faster. It can cause
problems when grid is hidden or partially overflowed by some its parent.
Absolute cursors also blinks when scrolling page or some grid parent tag (but not in grid itself).
By default TreeGrid uses fast absolute cursors for hover and slow relative cursors for focus.
Since 9.2 by default in Firefox are not used absolute cursors at all (AbsoluteCursors='0'), because they are remarkably slower in latest FF.
new 6.6 chg 11.0 <Cfg> int
BorderCursors
[1]
If Border and Background hover and focus cursors are displayed.
0 - Never,
1 - in all browsers (also in Safari, Chrome and Opera),
2 - only in fast browsers (IE and FF).
Since 10.0 also on iPad.
In runtime it has only two values
0 or
1.
Since 11.0. By default are the cursors for Opera, Safari and Google Chrome also enabled, because the newest versions of these browsers are enough fast.
deleted 6.6 <Cfg> bool
SafariCursors
[0]
Renamed to BorderCursors and values meaning changed.
new 11.0 <Cfg> int
FocusCellBorderCursor
[0]
Mouse cursor when above focused cell border.
0 - default,
1 - move,
2 - resize.
new 6.0 <I><C><cell> string[ ]
HoverRow
[...]
How the whole row will be hovered. A list of comma separated keywords.
Border | Border around the whole row. |
Background | Background over the whole row except the actual cell, it is done by opacity. Not for Space rows. |
Color | Background color for all cells in the row except the actual cell, it is computed color - it differs according to the actual row state and background. Can remarkably slow down the hover! |
Class | N / A |
Default value is "Background" for Header and Panel, "" for Space and "Border,Background" for all other rows.
new 6.0 <I><C><cell> string[ ]
HoverCell
[...]
How the cell will be hovered. A list of comma separated keywords.
Border | Border around the cell. |
Background | N / A |
Color | Cell background color, it is computed color - it differs according to the actual row state and background. Can slightly slow down the hover! |
Class | Cell class for change text properties like font or color. Can remarkably slow down the hover! |
Default value is "Color" for Header, Panel and Space and "Border,Color" for all other cells.
new 6.0 <I><C><cell><Root> string[ ]
FocusRow
[...]
How the whole row will be focused. A list of comma separated keywords. Root is for not rendered pages.
Border | Border around the whole row. |
Background | Background over the whole row except the actual cell, it is done by opacity. Not for Space rows. |
Color | Background color for all cells in the row except the actual cell, it is computed color - it differs according to the actual row state and background. Can slow down the focus! |
Class | Cell class for all cells in the row except the actual cell, for change text properties like font or color. Can remarkably slow down the focus! |
Default value is "Background" for Header, "" for Space and "Border,Background" for all other rows.
new 6.0 upd 11.0 <I><C><cell><Root> string[ ]
FocusCell
[Border,Color,Class]
How the cell will be focused. A list of comma separated keywords. Root is for not rendered pages.
Border | Border around the cell. |
Background | N / A |
Color | Cell background color, it is computed color - it differs according to the actual row state and background. |
Class | Cell class for change text properties like font or color. Can slightly slow down the focus! |
Corner | (new 11.0) Bottom right corner point. For auto fill or other dragging rectangle features. |
| It can be shown also in edit mode if set <Cfg DragEdit/> |
new 11.0 <C> int
ColorCursor
[0]
If set, the column cell will be colored if the row has appropriate flag. Bit array.
Only for left and right side columns. Only if permitted by <Cfg ColorCursor/>
1. bit | &1 | The row is hovered, it is ARow. |
2. bit | &2 | The row is in focused range, inside FRect. |
3. bit | &4 | The row has focus, it is FRow. |
4. bit | &8 | The row or its cells are selected. It has set Selected attribute. |
5. bit | &16 | Set it to columns with no other ColorCursor bits set to not show the row ColorCursor. |
new 11.0 <I> int
ColorCursor
[0]
If set, the row cell will be colored if the column has appropriate flag. Bit array.
Only for fixed rows. Only if permitted by <Cfg ColorCursor/>. Cannot be set to default row.
1. bit | &1 | The column is hovered, it is ACol. |
2. bit | &2 | The column is in focused range, inside FRect. |
3. bit | &4 | The column has focus, it is FCol. |
4. bit | &8 | The column cells are selected. There is at least one row with cell attribute in this column with Selected = 1. |
5. bit | &16 | Set it to row with no other ColorCursor bits set to not show the column ColorCursor. |
new 11.0 <Cfg> int
ColorCursor
[0]
Must be set to support the rows and columns attributes
ColorCursor.
Bit array, set the bits to permit the bits in row and column attributes
ColorCursor.
1. bit - | 4. bit | See row or column ColorCursor. |
5. bit | &16 | If set, the cell will have set also special CSS class to control other style attributes than background color. It can slow down the action. |
<Cfg> int
FocusWholeRow
[0]
If set, does not show cursor for the cell, only for row.
For this case should be set also
<Cfg Editing='0'/>