- Loading...
...
Header is the topmost table row showing names of columns. It is always visible as it does not scroll with content. It is a place where the user performs table column customization including column resizing, column rearrangement, column hiding/showing and sorting* sorting. Header can span multiple columns, if it shows* grouped shows grouped columns{* with } with the name of the group above individual column names.
...
By default, the tree is displayed in the left-most column, however, application developers are allowed to specify the column in which the tree is displayed..The most left column in JavaFX TreeTable control shows a tree.
A tree consists of nodes that can be opened and closed by interacting with a "turner" icon. The very first node in the tree is called root node and it is possible to hide it. Nodes that contain other nodes are called parents (these nodes have the "turner" icon); nodes that do not contain any other nodes are called leaf nodes (these nodes do not have the "turner" icon). Nodes can be opened by clicking on the "turner" icons or by double clicking the node name (note that if editing is enabled, double click will enter the edit mode).
...
In the multiple selection mode, one selected row is marked as an anchor. It indicates the beginning of a range selection when making the range selection with pointing device (SHIFT Click).
Note that selection in the tree should be preserved so when users select a child node and then close and reopen its parent, selection should still remain on that child node.
A tree table control with a selection and focus should have "A tree table control with a selection and focus should have "primary highlighting" to show selection. A tree table with a selection but without focus should show "secondary highlighting" for the selection. These states apply to root, parent, child, leaf node in both the open and closed states.
...
JavaFX TreeTable supports drag and drop of nodes (rows) and columns. To rearrange columns, users must drag a single item it doesn't need to be selected. The user can just drag the item's label (not a white space). Dragging on white space initiates multi-selection. To drag multiple items at once, the user needs to select them first. The default drag and drop action is cut-and-paste. It is possible to initiate copy-and-paste when holding CTRL key (OPTION key on Mac) during dragging.
To rearrange columns, users must drag a column header to a new position. When dropped, new position of the column is preserved. Please note that the most left column is designed to show a tree structure. It means that a column that is dropped in the most left column will show the tree structure.
Column rearrangement in a tree table control
Similarly to column rearrangement, users can rearrange nodes within the tree by dragging them to a new location. When dropped, the tree is rearranged and its new state is preserved. Note that pressing CTRL key (OPTION key on Mac) while dragging a node to a new location creates a copy of that node in the new location.
column header to a new position. When dropped, new position of the column is preserved.
Column rearrangement in a tree
Node rearrangement in a tree table control
...
Up | Move focus & selection up by one item. Create anchor. Cancel all previous selections. |
Down | Move focus & selection down by one item. Create anchor. Cancel all previous selections. |
Left | Row: Collapse current selection (or go to the parent node) |
Right | Row: Expand current selection (or go to the first child node). |
Ctrl-Up | Move focus up by one item without changing selection. |
Ctrl-Down | Move focus down by one item without changing selection. |
Shift-Up | Expand or contract selection up by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Up key should be processed. See description of Up behavior for more details. |
Shift-Down | Expand or contract selection down by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Down key should be processed. See description of Down behavior for more details. |
Space | Select focused item if it is not selected. |
Ctrl-Space | Select focused item if it is not selected. Deselect focused item if it is selected. Create anchor. |
Shift-Space | Select all items between anchor and focused item. Focused item is also included in the selection. All previous selections are canceled, if applicable. Available in multi-selection mode onlyonly. In single selection mode, Shift key should be ignored and only Space key should be processed. See description of Space behavior for more details. |
F2 | Edit selected item. |
Home | Move focus & selection to the first item. Create anchor. |
End | Move focus & selection to the last item. Create anchor. |
Shift-Home | Select all items between anchor and the first item. All previous selections are canceled, if applicable. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Home key should be processed. See description of Home behavior for more details. |
Shift-End | Select all items between anchor and the last item. All previous selections are canceled, if applicable. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only End key should be processed. See description of End behavior for more details. |
Ctrl-Home | Move focus to the first item. |
Ctrl-End | Move focus to the last item. |
PageUp | Move the selection up on the first fully visible item on the current page. If the first fully visible item is selected, move the selection on the first fully visible item on the previous page. |
PageDown | Move the selection down on the last fully visible item on the current page. If the last fully visible item is selected, move the selection on the last fully visible item on the next page. |
Shift-PageUp | Select all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page. In single selection mode, Shift key should be ignored and only PageUp key should be processed. See description of PageUp behavior for more details. |
Shift-PageDown | Select all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page. In single selection mode, Shift key should be ignored and only PageDown key should be processed. See description of PageDown behavior for more details. |
Ctrl-PageUp | Move focus up on the first fully visible item on the current page. If the first fully visible item is focused, move focus on the first fully visible item on the previous page. |
Ctrl-PageDown | Move focus down on the last fully visible item on the current page. If the last fully visible item is focused, move focus on the last fully visible item on the next page. |
Ctrl-A | Select entire tree table. In multi-selection mode only. |
Esc | Cancel editing. |
Enter | Confirm editing (depends on the cell editor). |
Ctrl-Shift-Up | Expand or contract selection up by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Ctrl-Up should be processed. See description of Ctrl-Up behavior for more details. |
Ctrl-Shift-Down | Expand or contract selection down by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Ctrl-Down should be processed. See description of Ctrl-Down behavior for more details. |
Ctrl-Shift-Space | Select all items between anchor and focused item. Focused item is also included in the selection. Create anchor. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Ctrl-Space should be processed. See description of Ctrl-Space behavior for more details. |
Ctrl-Shift-Space Home | Select all items between anchor and focused the first item. Focused item is also included in the selection. Available in multi-selection mode onlyonly. In single selection mode, Shift key should be ignored and only Ctrl-Home should be processed. See description of Ctrl-Home behavior for more details. |
Ctrl-Shift-Home End | Select all items between anchor and the first last item. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Ctrl-Shift-End Select all items between anchor and the last item. Available in multi-selection mode onlyEnd should be processed. See description of Ctrl-End behavior for more details. |
Ctrl-Shift-PageUp | Select all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page. In single selection mode, Shift key should be ignored and only Ctrl-PageUp should be processed. See description of Ctrl-PageUp behavior for more details. |
Ctrl-Shift-PageDown | Select all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page. In single selection mode, Shift key should be ignored and only Ctrl-PageDown should be processed. See description of Ctrl-PageDown behavior for more details. |
* (numlock) | When a node is selected, expand all nodes. |
+ (numlock) | When a parent node is selected, expand the node. |
- (numlock) | When a parent node is selected, collapse the node. |
...
Up | Move focus & selection up by one item. Create anchor. Cancel all previous selections. | ||||
Down | Move focus & selection down by one item. Create anchor. Cancel all previous selections. | ||||
Left | Row: Collapse current selection (or go to the parent node) | ||||
Right | Row: Expand current selection (or go to the first child node). | ||||
Cmd-Up | Move focus up by one item without changing selection. | ||||
Cmd-Down | Move focus down by one item without changing selection. | ||||
Shift-Up | Expand or contract selection up by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Up key should be processed. See description of Up behavior for more details. | ||||
Shift-Down | Expand or contract selection down by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Down key should be processed. See description of Down behavior for more details. | ||||
Space | Select focused item if it is not selected. | ||||
Cmd-Ctrl-Space | Select focused item if it is not selected. Deselect focused item if it is selected. Create anchor. | ||||
Shift-Space | Select all items between anchor and focused item. Focused item is also included in the selection. All previous selections are canceled, if applicable. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Space key should be processed. See description of Space behavior for more details. | ||||
F2 | Edit selected item. | ||||
Home | Move focus & selection to the first item. Create anchor. | ||||
End | Move focus & selection to the last item. Create anchor. | ||||
Shift-Home | Select all items between anchor and the first item. All previous selections are canceled, if applicable. Available in multi-selection mode only. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Home key should be processed. See description of Home behavior for more details. | ||||
Shift-End | Select all items between anchor and the last item. All previous selections are canceled, if applicable. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only End key should be processed. See description of End behavior for more details. | ||||
Cmd-Home | Move focus to the first item. | ||||
Cmd-End | Move focus to the last item. | ||||
PageUp | Move the selection up on the first fully visible item on the current page. If the first fully visible item is selected, move the selection on the first fully visible item on the previous page. | ||||
PageDown | Move the selection down on the last fully visible item on the current page. If the last fully visible item is selected, move the selection on the last fully visible item on the next page. | ||||
Shift-PageUp | Select all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page. In single selection mode, Shift key should be ignored and only PageUp key should be processed. See description of PageUp behavior for more details. | ||||
Shift-PageDown | Select all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page. In single selection mode, Shift key should be ignored and only PageDown key should be processed. See description of PageDown behavior for more details. | ||||
Cmd-PageUp | Move focus up on the first up on the first fully visible item on the current page. If the first fully visible item is focused, move focus on the first fully visible item on the previous page. | ||||
Cmd-PageDown | Move focus down on the last fully visible item on the current page. If the first last fully visible item is focused, move focus on the first last fully visible item on the previous next page. | ||||
Cmd-A | Select entire tree table. In multi-selection mode only. | ||||
Esc | Cancel editing. | ||||
Enter | Confirm editing (depends on the cell editor). | ||||
Cmd-Shift-Up | Expand or contract selection up by one item. Only in multi-selection modes. | Move focus down on the last fully visible item on the current page. If the last fully visible item is focused, move focus on the last fully visible item on the next page. | |||
Cmd-A | Select entire tree table. In multi-selection mode only. | ||||
Esc | Cancel editing. | ||||
Enter | Confirm editing (depends on the cell editor). | ||||
-Shift-Up selects all items between anchor and the item which is right above the focused item. The item which is right above the focused item is also included in the selection. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Cmd-Up should be processed. See description of Cmd-Up behavior for more details. | |||||
Cmd-Shift-Down | Expand or contract selection down | Cmd-Shift-Up | Expand or contract selection up by one item. Only in multi-selection modes. | Cmd-Shift-Down | In single selection mode, Shift key should be ignored and only Cmd-Down should be processed. See description of Cmd-Down behavior for more details. |
Cmd-Shift-Space | Select Expand or contract selection down by one item. Only in multi-selection modes. In single selection mode, Shift key should be ignored and only Cmd-Space should be processed. See description of Cmd-Space behavior for more details. | ||||
Cmd-Shift-Space Home | Select all items between anchor and focused item. Focused item is also included in the selectionthe first item. Available in multi-selection mode only. In single selection mode, Shift key should be ignored and only Cmd-Home should be processed. See description of Cmd-Home behavior for more details. | ||||
Cmd-Shift-Home End | Select all items between anchor and the first last item. Available in multi-selection mode only. | Cmd-Shift-End | Select all items between anchor and the last item. Available in multi-selection mode onlyIn single selection mode, Shift key should be ignored and only Cmd-End should be processed. See description of Cmd-End behavior for more details. | ||
Cmd-Shift-PageUp | Select all items between anchor and the first fully visible item on the current page. If the first fully visible item is already included in the selection, extend the selection to the first fully visible item on the previous page. In single selection mode, Shift key should be ignored and only Cmd-PageUp should be processed. See description of Cmd-PageUp behavior for more details. | ||||
Cmd-Shift-PageDown | Select all items between anchor and the last fully visible item on the current page. If the last fully visible item is already included in the selection, extend the selection to the last fully visible item on the next page. In single selection mode, Shift key should be ignored and only Cmd-PageDown should be processed. See description of Cmd-PageDown behavior for more details. | ||||
* (numlock) | When a node is selected, expand all nodes. | ||||
+ (numlock) | When a parent node is selected, expand the node. | ||||
- (numlock) | When a parent node is selected, collapse the node. |