TreeView
TreeView class, a child class of GridBase.
Signature:
export declare class TreeView extends GridBase Extends : GridBase
Remarks
[Parent Class]
Events
| Property | Type | Description |
|---|---|---|
| onTreeItemChanged | (tree: TreeView, itemIndex: number, rowId: number) => void | A callback notifying that the value of the TreeView has changed |
| onTreeItemCollapsed | (tree: TreeView, itemIndex: number, rowId: number) => void | Callback notifying that the TreeView's item node is closed |
| onTreeItemCollapsing | (tree: TreeView, itemIndex: number, rowId: number) => void | A callback that determines the collapse of the TreeView's item nodes |
| onTreeItemExpanded | (tree: TreeView, itemIndex: number, rowId: number) => void | A callback notifying that the TreeView's item node has been expanded |
| onTreeItemExpanding | (tree: TreeView, itemIndex: number, rowId: number) => boolean | A callback that determines the expansion of item nodes in the TreeView |
Properties
| Property | Type | Description |
|---|---|---|
| treeOptions | TreeOptions | Setting model unique to TreeView |
Methods
| Method | Type | Description |
|---|---|---|
| checkChildren(itemIndex, checked, recursive, visibleOnly, checkableOnly, checkEvent) | checkChildren(itemIndex: number, checked: boolean, recursive: boolean, visibleOnly: boolean, checkableOnly: boolean, checkEvent?: boolean): void; | Checks or unchecks the child rows of the input row. |
| collapse(itemIndex, recursive) | collapse(itemIndex: number, recursive?: boolean): void; | Collapse the row. |
| collapseAll() | collapseAll(): void; | Collapse all rows. |
| collapseModel(model, recursive) | collapseModel(model: GridItem, recursive: boolean): void; | Collapse an item (row). |
| expand(itemIndex, recursive, force, level) | expand(itemIndex: number, recursive?: boolean, force?: boolean, level?: number): void; | Expand the row. |
| expandAll(level, renewHasChildren) | expandAll(level?: number, renewHasChildren?: boolean): void; | Expand all rows. |
| expandModel(model, recursive, force, level) | expandModel(model: GridItem, recursive?: boolean, force?: boolean, level?: number): void; | Expand the item (row). |
| getAncestors(itemIndex, includeRoot) | getAncestors(itemIndex: number, includeRoot?: boolean): number[]; | Returns the indices of ancestor rows. |
| getCheckedItems() | getCheckedItems(): number[]; | Returns the index list of checked items as an array. |
| getCheckedRows(visibleOnly) | getCheckedRows(visibleOnly: boolean): number[]; | Returns a list of indices of checked data rows. |
| getChildren(itemIndex) | getChildren(itemIndex: number): number[]; | Returns the indices of child rows. |
| getDataSource() | getDataSource(): LocalTreeDataProvider; | Returns the DataProvider connected to the tree. |
| getDescendants(itemIndex) | getDescendants(itemIndex: number): number[]; | Returns the indices of child rows. |
| getParent(itemIndex) | getParent(itemIndex: number): number; | Returns the index of the parent row. |
| getTreeOptions() | getTreeOptions(): TreeOptions; | Retrieves related setting information, such as tree grid selection display. |
| setOptions(options) | setOptions(options: TreeViewOptions): void; | |
| setTreeOptions(options) | setTreeOptions(options: TreeOptions): void; | Make settings related to tree view display and operation. |
Events Desc
onTreeItemChanged
A callback notifying that the value of the TreeView has changed
Type - (tree: TreeView, itemIndex: number, rowId: number) => void
Remarks:
Occurs at commit() after the value has been changed.
[Parameter list]
tree - TreeView control
itemIndex - Index of the row whose value changed
rowId - Unique number of the row whose value was changed
Example:
treeView.onTreeItemChanged = function (tree, itemIndex, rowId) {
console.log("TreeItem item changed:: " + itemIndex);
};onTreeItemCollapsed
A callback notifying that the TreeView's item node has been depleted.
Type - (tree: TreeView, itemIndex: number, rowId: number) => void
Remarks:
[Parameter list]
tree - TreeView control
itemIndex - Index of the collapsed item row
rowId - Unique number of the collapsed row
Example:
treeView.onTreeItemCollapsed = function (tree, itemIndex, rowId) {
console.log('Collapsed at: ' + itemIndex);
};onTreeItemCollapse
A callback that determines the collapse of item nodes in the TreeView.
Type - (tree: TreeView, itemIndex: number, rowId: number) => void
Remarks:
[Parameter list]
tree - TreeView control
itemIndex - Index of the row you want to collapse
rowId - Unique number of the row you want to collapse
[Return value] - If false is returned, it will not be expanded.
Example:
treeView.onTreeItemCollapsing = function (tree, itemIndex, rowId) {
return false;
};onTreeItemExpanded
Callback notifying that the TreeView's item node has been expanded
Type - (tree: TreeView, itemIndex: number, rowId: number) => void
Remarks:
[Parameter list]
tree - TreeView control
itemIndex - index of expanded row
rowId - Unique number of the expanded row
Example:
treeView.onTreeItemExpanded = function (tree, itemIndex, rowId) {
console.log('Expanded at: ' + itemIndex);
};onTreeItemExpanding
A callback that determines the expansion of item nodes in the TreeView.
Type - (tree: TreeView, itemIndex: number, rowId: number) => boolean
Remarks:
[Parameter list]
tree - TreeView control
itemIndex - Index of the row to expand
rowId - Unique number of the row to be expanded
[Return value] - If false is returned, it will not be expanded.
Example:
treeView.onTreeItemExpanding = function (tree, itemIndex, rowId) {
return false;
};Properties Desc
treeOptions
Setting model unique to TreeView
Type - TreeOptions
Remarks:
TreeOptions Returns an object. You can get or set the properties of TreeOptions.
Example:
treeView.treeOptions.iconWidth = 20;Method Desc
checkChildren
Checks or unchecks the child rows of the input row.
[Parameter List]
itemIndex - number
ItemModel index of parent row
checked - boolean
true: checked, false: off
recursive - boolean
Default: false, whether to expand descendant groups included in the group.
visibleOnly - boolean
If true, rows that collapse or are not visible during paging are excluded.
checkableOnly - boolean
If true, only checkable items are checked.
checkEvent - boolean
Default: true, whether onItemChecked() occurs.
[Return Value] - void
Example:
treeView.checkChildren(4, true, true, true, true);collapse
Collapse the row.
[Parameter List]
itemIndex - number
Index of the row you want to collapse
recursive - boolean
Default: false, whether or not descendant groups included in the group are collapsed.
[Return Value] - void
Example:
tree.collapse(3);collapseAll
Collapse all rows.
Example:
tree.collapseAll();collapseModel
Collapse an item (row).
[Parameter List]
model - GridItem
The item model you want to collapse
recursive - boolean
Default: false, whether or not descendant groups included in the group are collapsed.
[Return Value] - void
Example:
let model = tree.getModel(4);
tree.collapseModel(model);expand
Expand the row.
[Parameter List]
itemIndex - number
Index of the row you want to expand
recursive - boolean
Default: false, whether to expand descendant groups included in the group.
force - boolean
Default value: false, whether to expand descendants when recursive is true even if they are already expanded.
level - number
Default: 0, when 0 and recursive is true, expand all descendants.
[Return Value] - void
Remarks:
When recursive is true, if you specify a level, it expands to that level.
Example:
tree.expand(3);expandAll
Expands all rows.
[Parameter List]
level - number
Default: 0, when 0 and recursive is true, expand all descendants.
[Return Value] - void
Remarks:
When recursive is true, if you specify a level, it expands to that level.
Example:
tree.expandAll();expandModel
Expand the item (row).
[Parameter List]
model - GridItem
Model of the item you want to expand
recursive - boolean
Default: false, whether to expand descendant groups included in the group.
force - boolean
Default: false, whether to expand descendants when recursive is true even if already expanded
level - number
Default: 0, when 0 and recursive is true, expand all descendants.
[Return Value] - void
Remarks:
When recursive is true, if you specify a level, it expands to that level.
Example:
let model = tree.getModel(4);
tree.expandModel(model);getAncestors
Returns the indices of ancestor rows.
[Parameter List]
itemIndex - number
the index of that row
includeRoot - boolean
Default value: true, true: Returns the result value including the index of the hidden top root row.
[return value] - number[]
Example:
let aIndexes = tree.getAncestors(3);getCheckedItems
Returns the index list of checked items as an array.
Example:
let checkedItems = treeView.getCheckedItems();getCheckedRows
Returns a list of indices of checked data rows.
[Parameter List]
visibleOnly - boolean
Default value: false, if entered as true, rows that collapse or are not visible during paging are excluded.
[return value] - number[]
Example:
let checkedRows = treeView.getCheckedRows(true);getChildren
index of child rowsreturns the string.
[Parameter List]
itemIndex - number
index of parent row
[return value] - number[]
Example:
let cIndexes = tree.getChildren(3);getDataSource
Returns the DataProvider connected to the tree.
Example:
let ds = treeView.getDataSource();getDescendants
Returns the indices of child rows.
[Parameter List]
itemIndex - number
index of ancestor row
[return value] - number[]
Example:
let dIndexes = gridView.getDescendants(3);getParent
Returns the index of the parent row.
[Parameter List]
itemIndex - number
index of child row
[return value] - number
Example:
let pIndex = tree.getParent(3);getTreeOptions
Retrieves related setting information, such as tree grid selection display.
Example:
let treeOpts = tree.getTreeOptions();
treeOpts.lineVisible = false;
tree.setTreeOptions(treeOpts);setOptions
setTreeOptions
Make settings related to tree view display and operation.
[Parameter List]
options - TreeOptions
TreeOptions An object with the same content as the configuration model. You only need to change the properties you want to change.
[Return Value] - void
Remarks:
Use TreeOptions by specifying only the desired properties.
Example:
tree.setTreeOptions({lineVisible: false});