TreeGrid v6.6

Grid cursors – hover & focus

TreeGrid documentation index

 

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

 

<Cfg>                int          AbsoluteCursors     [5]                                                                                                                    new 6.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.

 

<Cfg>                int          BorderCursors           [2]                                                                                                                    new 6.6.

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).

In runtime it has only two values 0 or 1.

By default are the cursors for Opera, Safari and Google Chrome disabled. You can try to enable them to see if the performance is still good.

 

<Cfg>                bool       SafariCursors [0]                                                                                                            deleted 6.6.

Renamed to BorderCursors and values meaning changed

 

<I> <C> <cell> string[] HoverRow          [...]                                                                                                                                new 6.0 .

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.

 

<I> <C> <cell> string[]  HoverCell            [...]                                                                                                                                new 6.0 .

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.

 

<I> <C> <cell> <Root> string[]  FocusRow         [...]                                                                                                                   new 6.0 .

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.

 

<I> <C> <cell> <Root> string[]  FocusCell           [Border,Color,Class]                                                                                      new 6.0 .

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!

 

<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’/>