com.vaadin.flow.component.treegrid.TreeGrid API 24.3.12 | Vaadin

You're viewing an older version of Vaadin JavaDoc. Please see version 24.7.0 for the latest.

com.vaadin.flow.component.treegrid.

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.grid.Grid<T>

com.vaadin.flow.component.treegrid.TreeGrid<T>

Type Parameters:

T - the grid bean type

All Implemented Interfaces:

AttachNotifier, BlurNotifier<Grid<T>>, DetachNotifier, Focusable<Grid<T>>, FocusNotifier<Grid<T>>, HasElement, HasEnabled, HasSize, HasStyle, HasTheme, SortEvent.SortNotifier<Grid<T>,GridSortOrder<T>>, HasDataGenerators<T>, HasDataView<T,Void,GridDataView<T>>, HasLazyDataView<T,Void,GridLazyDataView<T>>, HasListDataView<T,GridListDataView<T>>, HasHierarchicalDataProvider<T>, Serializable

@JsModule("@vaadin/grid/src/vaadin-grid-tree-toggle.js") public class TreeGrid<T> extends Grid<T> implements HasHierarchicalDataProvider<T>

Tree Grid is a component for displaying hierarchical tabular data grouped into expandable and collapsible nodes. Tree Grid is an extension of the Grid component and all Grid?s features are available in Tree Grid as well.

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.flow.component.grid.Grid
Grid.AbstractGridExtension<T>, Grid.Column<T>, Grid.DataCommunicatorBuilder<T,U extends ArrayUpdater>, Grid.MultiSortPriority, Grid.NestedNullBehavior, Grid.SelectionMode, Grid.UpdateQueue

Nested classes/interfaces inherited from interface com.vaadin.flow.component.BlurNotifier
BlurNotifier.BlurEvent<C extends Component>

Nested classes/interfaces inherited from interface com.vaadin.flow.component.FocusNotifier
FocusNotifier.FocusEvent<C extends Component>
Constructor Summary

Constructors

Constructor

Description

TreeGrid()

Creates a new TreeGrid without support for creating columns based on property names.

TreeGrid(HierarchicalDataProvider<T,?> dataProvider)

Creates a new TreeGrid using the given HierarchicalDataProvider, without support for creating columns based on property names.

TreeGrid(Class<T> beanType)

Creates a new TreeGrid with an initial set of columns for each of the bean's properties.
Method Summary

Modifier and Type

Method

Description

Registration

addCollapseListener(ComponentEventListener<CollapseEvent<T,TreeGrid<T>>> listener)

Adds a CollapseEvent listener to this TreeGrid.

<V extends Component> Grid.Column<T>

addComponentHierarchyColumn(ValueProvider<T,V> componentProvider)

Adds a new Hierarchy column that shows components.

Registration

addExpandListener(ComponentEventListener<ExpandEvent<T,TreeGrid<T>>> listener)

Adds an ExpandEvent listener to this TreeGrid.

Grid.Column<T>

addHierarchyColumn(ValueProvider<T,?> valueProvider)

Adds a new Hierarchy column to this Grid with a value provider.

void

collapse(Collection<T> items)

Collapse the given items.

protected void

collapse(Collection<T> items, boolean userOriginated)

Collapse the given items.

void

collapse(T... items)

Collapse the given items.

void

collapseRecursively(Collection<T> items, int depth)

Collapse the given items and their children recursively until the given depth.

void

collapseRecursively(Stream<T> items, int depth)

Collapse the given items and their children recursively until the given depth.

protected GridArrayUpdater

createDefaultArrayUpdater(SerializableBiFunction<GridArrayUpdater.UpdateQueueData,Integer,Grid.UpdateQueue> updateQueueFactory)

void

expand(Collection<T> items)

Expands the given items.

protected void

expand(Collection<T> items, boolean userOriginated)

Expands the given items.

void

expand(T... items)

Expands the given items.

void

expandRecursively(Collection<T> items, int depth)

Expands the given items and their children recursively until the given depth.

void

expandRecursively(Stream<T> items, int depth)

Expands the given items and their children recursively until the given depth.

HierarchicalDataCommunicator<T>

getDataCommunicator()

Returns the data communicator of this Grid.

HierarchicalDataProvider<T,SerializablePredicate<T>>

getDataProvider()

Returns the data provider of this grid.

GridDataView<T>

getGenericDataView()

Deprecated.
not supported

protected Collection<T>

getItemsWithChildrenRecursively(Collection<T> items, int depth)

Gets given items and their children recursively until the given depth.

GridLazyDataView<T>

getLazyDataView()

Deprecated.
not supported

GridListDataView<T>

getListDataView()

Deprecated.
not supported

boolean

isExpanded(T item)

Returns whether a given item is expanded or collapsed.

void

scrollToEnd()

Scrolls to the last data row of the grid.

void

scrollToIndex(int rowIndex)

Scrolls to the index of an item in the root level of the tree.

void

scrollToIndex(int... indexes)

Scrolls to a nested item within the tree.

Grid.Column<T>

setColumns(String hierarchyPropertyName, ValueProvider<T,?> valueProvider, Collection<String> propertyNames)

Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).

void

setDataProvider(DataProvider<T,?> dataProvider)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

void

setDataProvider(HierarchicalDataProvider<T,?> hierarchicalDataProvider)

Sets the hierarchical data provider for this listing.

Grid.Column<T>

setHierarchyColumn(String propertyName)

Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).

Grid.Column<T>

setHierarchyColumn(String propertyName, ValueProvider<T,?> valueProvider)

Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).

GridLazyDataView<T>

setItems(BackEndDataProvider<T,Void> dataProvider)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

GridLazyDataView<T>

setItems(CallbackDataProvider.FetchCallback<T,Void> fetchCallback)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

GridListDataView<T>

setItems(ListDataProvider<T> dataProvider)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

GridListDataView<T>

setItems(Collection<T> items)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

GridListDataView<T>

setItems(T... items)

Deprecated.
use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.

void

setUniqueKeyDataGenerator(String propertyName, ValueProvider<T,String> uniqueKeyProvider)

Sets property name and value provider for unique key in row's generated JSON.

Methods inherited from class com.vaadin.flow.component.grid.Grid
addCellFocusListener, addColumn, addColumn, addColumn, addColumn, addColumn, addColumn, addColumn, addColumnReorderListener, addColumnResizeListener, addColumns, addComponentColumn, addContextMenu, addDataGenerator, addDragEndListener, addDragStartListener, addDropListener, addFirstHeaderRow, addItemClickListener, addItemDoubleClickListener, addSelectionListener, addSortListener, addThemeVariants, addValueProvider, appendFooterRow, appendHeaderRow, asMultiSelect, asSingleSelect, compareMaybeComparables, configureBeanType, createColumn, createColumnId, createEditor, createSortingComparator, deselect, deselectAll, getArrayUpdater, getBeanType, getClassNameGenerator, getColumnByKey, getColumnLayers, getColumnRendering, getColumns, getDefaultColumnFactory, getDefaultHeaderRow, getDragFilter, getDropFilter, getDropMode, getEditor, getFooterRows, getHeaderRows, getNestedNullBehavior, getPageSize, getPartNameGenerator, getPropertySet, getSelectedItems, getSelectionModel, getSortOrder, getUniqueKeyProperty, getUniqueKeyProvider, initConnector, insertColumnLayer, isAllRowsVisible, isColumnReorderingAllowed, isDetailsVisible, isDetailsVisibleOnClick, isMultiSort, isRowsDraggable, onAttach, onDataProviderChange, onDetach, onEnabledStateChanged, prependFooterRow, prependHeaderRow, recalculateColumnWidths, removeAllColumns, removeColumn, removeColumnByKey, removeColumnLayer, removeColumns, removeThemeVariants, scrollToStart, select, setAllRowsVisible, setClassNameGenerator, setColumnKey, setColumnOrder, setColumnOrder, setColumnRendering, setColumnReorderingAllowed, setColumns, setDefaultMultiSortPriority, setDetailsVisible, setDetailsVisibleOnClick, setDragDataGenerator, setDragFilter, setDropFilter, setDropMode, setItemDetailsRenderer, setItems, setItems, setMultiSort, setMultiSort, setMultiSort, setMultiSort, setNestedNullBehavior, setPageSize, setPartNameGenerator, setRowsDraggable, setSelectionDragDetails, setSelectionMode, setSelectionModel, setSortableColumns, setTooltipGenerator, setUniqueKeyProperty, setUniqueKeyProvider, sort, updateSelectionModeOnClient

Methods inherited from class com.vaadin.flow.component.Component
addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, removeFromParent, scrollIntoView, scrollIntoView, set, setElement, setId, setVisible

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.flow.component.AttachNotifier
addAttachListener

Methods inherited from interface com.vaadin.flow.component.BlurNotifier
addBlurListener

Methods inherited from interface com.vaadin.flow.component.DetachNotifier
addDetachListener

Methods inherited from interface com.vaadin.flow.component.Focusable
addFocusShortcut, blur, focus, getTabIndex, setTabIndex

Methods inherited from interface com.vaadin.flow.component.FocusNotifier
addFocusListener

Methods inherited from interface com.vaadin.flow.component.HasElement
getElement

Methods inherited from interface com.vaadin.flow.component.HasEnabled
isEnabled, setEnabled

Methods inherited from interface com.vaadin.flow.data.provider.hierarchy.HasHierarchicalDataProvider
getTreeData, setItems, setItems, setTreeData

Methods inherited from interface com.vaadin.flow.data.provider.HasLazyDataView
setItems

Methods inherited from interface com.vaadin.flow.component.HasSize
getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull

Methods inherited from interface com.vaadin.flow.component.HasStyle
addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

Methods inherited from interface com.vaadin.flow.component.HasTheme
addThemeName, addThemeNames, getThemeName, getThemeNames, hasThemeName, removeThemeName, removeThemeNames, setThemeName, setThemeName

Constructor Details
- TreeGrid
  
  public TreeGrid()
  
  Creates a new TreeGrid without support for creating columns based on property names. Use an alternative constructor, such as TreeGrid(Class), to create a TreeGrid that automatically sets up columns based on the type of presented data.
- TreeGrid
  
  public TreeGrid(Class<T> beanType)
  
  Creates a new TreeGrid with an initial set of columns for each of the bean's properties. The property-values of the bean will be converted to Strings. Full names of the properties will be used as the column keys and the property captions will be used as the column headers.
  
  Parameters:
  
  beanType - the bean type to use, not null
- TreeGrid
  
  public TreeGrid(HierarchicalDataProvider<T,?> dataProvider)
  
  Creates a new TreeGrid using the given HierarchicalDataProvider, without support for creating columns based on property names. Use an alternative constructor, such as TreeGrid(Class), to create a TreeGrid that automatically sets up columns based on the type of presented data.
  
  Parameters:
  
  dataProvider - the data provider, not null
Method Details
- createDefaultArrayUpdater
  
  protected GridArrayUpdater createDefaultArrayUpdater(SerializableBiFunction<GridArrayUpdater.UpdateQueueData,Integer,Grid.UpdateQueue> updateQueueFactory)
  
  Overrides:
  
  createDefaultArrayUpdater in class Grid<T>
- setUniqueKeyDataGenerator
  
  public void setUniqueKeyDataGenerator(String propertyName, ValueProvider<T,String> uniqueKeyProvider)
  
  Sets property name and value provider for unique key in row's generated JSON.
  Default property name is 'key' and value is generated by bean's hashCode method.
  
  Parameters:
  
  propertyName - Property name in JSON data
  
  uniqueKeyProvider - Value provider for the target property in JSON data
- addExpandListener
  
  public Registration addExpandListener(ComponentEventListener<ExpandEvent<T,TreeGrid<T>>> listener)
  
  Adds an ExpandEvent listener to this TreeGrid.
  Parameters:
  
  listener - the listener to add
  
  Returns:
  
  a registration for the listener
  
  See Also:
  
  ExpandEvent
- addCollapseListener
  
  public Registration addCollapseListener(ComponentEventListener<CollapseEvent<T,TreeGrid<T>>> listener)
  
  Adds a CollapseEvent listener to this TreeGrid.
  Parameters:
  
  listener - the listener to add
  
  Returns:
  
  a registration for the listener
  
  See Also:
  
  CollapseEvent
- setDataProvider
  
  public void setDataProvider(DataProvider<T,?> dataProvider)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid only supports hierarchical data providers. Use setDataProvider(HierarchicalDataProvider) instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Overrides:
  
  setDataProvider in class Grid<T>
  
  Parameters:
  
  dataProvider - the data provider
- setDataProvider
  
  public void setDataProvider(HierarchicalDataProvider<T,?> hierarchicalDataProvider)
  
  Description copied from interface: HasHierarchicalDataProvider
  
  Sets the hierarchical data provider for this listing. The data provider provides the items and the hierarchy as needed.
  
  Specified by:
  
  setDataProvider in interface HasHierarchicalDataProvider<T>
  
  Parameters:
  
  hierarchicalDataProvider - the hierarchical data provider to use, not null
- setItems
  
  @Deprecated public GridLazyDataView<T> setItems(BackEndDataProvider<T,Void> dataProvider)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid does not support data views. Use setDataProvider(HierarchicalDataProvider) instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  setItems in interface HasLazyDataView<T,Void,GridLazyDataView<T>>
  
  Overrides:
  
  setItems in class Grid<T>
  
  Parameters:
  
  dataProvider - the data provider
  
  Returns:
  
  the data view
- setItems
  
  @Deprecated public GridLazyDataView<T> setItems(CallbackDataProvider.FetchCallback<T,Void> fetchCallback)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid supports only hierarchical data so use another method instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  setItems in interface HasLazyDataView<T,Void,GridLazyDataView<T>>
  
  Parameters:
  
  fetchCallback - the fetch callback
  
  Returns:
  
  the data view
- setItems
  
  @Deprecated public GridListDataView<T> setItems(ListDataProvider<T> dataProvider)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid supports only hierarchical data providers so use another method instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  setItems in interface HasListDataView<T,GridListDataView<T>>
  
  Overrides:
  
  setItems in class Grid<T>
  
  Parameters:
  
  dataProvider - the data provider
  
  Returns:
  
  the data view
- setItems
  
  @Deprecated public GridListDataView<T> setItems(T... items)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid supports only hierarchical data so use another method instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  setItems in interface HasListDataView<T,GridListDataView<T>>
  
  Parameters:
  
  items - the items to display, not null
  
  Returns:
  
  the data view
- setItems
  
  @Deprecated public GridListDataView<T> setItems(Collection<T> items)
  
  Deprecated.
  use setDataProvider(HierarchicalDataProvider), HasHierarchicalDataProvider.setItems(Collection, ValueProvider), HasHierarchicalDataProvider.setItems(Stream, ValueProvider) or HasHierarchicalDataProvider.setTreeData(TreeData) instead.
  
  Tree grid supports only hierarchical data, so use another method instead.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  setItems in interface HasListDataView<T,GridListDataView<T>>
  
  Parameters:
  
  items - the items to display, not null
  
  Returns:
  
  the data view
- getListDataView
  
  @Deprecated public GridListDataView<T> getListDataView()
  
  Deprecated.
  not supported
  
  Tree grid does not support list data view.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  getListDataView in interface HasListDataView<T,GridListDataView<T>>
  
  Overrides:
  
  getListDataView in class Grid<T>
  
  Returns:
  
  exception is thrown
- getLazyDataView
  
  @Deprecated public GridLazyDataView<T> getLazyDataView()
  
  Deprecated.
  not supported
  
  Tree grid does not support list data view.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  
  Specified by:
  
  getLazyDataView in interface HasLazyDataView<T,Void,GridLazyDataView<T>>
  
  Overrides:
  
  getLazyDataView in class Grid<T>
  
  Returns:
  
  exception is thrown
- getGenericDataView
  
  @Deprecated public GridDataView<T> getGenericDataView()
  
  Deprecated.
  not supported
  
  Tree grid does not support list data view.
  This method is inherited from Grid and has been marked as deprecated to indicate that it is not supported. This method will throw an UnsupportedOperationException.
  Specified by:
  
  getGenericDataView in interface HasDataView<T,Void,GridDataView<T>>
  
  Overrides:
  
  getGenericDataView in class Grid<T>
  
  Returns:
  
  exception is thrown
  
  See Also:
  
  Grid.getListDataView()
  
  Grid.getLazyDataView()
- addHierarchyColumn
  
  public Grid.Column<T> addHierarchyColumn(ValueProvider<T,?> valueProvider)
  
  Adds a new Hierarchy column to this Grid with a value provider. The value is converted to String when sent to the client by using String.valueOf(Object).
  Hierarchy column is rendered by using 'vaadin-grid-tree-toggle' web component.
  
  Parameters:
  
  valueProvider - the value provider
  
  Returns:
  
  the created hierarchy column
- addComponentHierarchyColumn
  
  public <V extends Component> Grid.Column<T> addComponentHierarchyColumn(ValueProvider<T,V> componentProvider)
  
  Adds a new Hierarchy column that shows components.
  NOTE: Using ComponentRenderer is not as efficient as the built in renderers.
  Type Parameters:
  
  V - the component type
  
  Parameters:
  
  componentProvider - a value provider that will return a component for the given item
  
  Returns:
  
  the new column
  
  See Also:
  
  Grid.addColumn(Renderer)
  
  Grid.removeColumn(Column)
- setHierarchyColumn
  
  public Grid.Column<T> setHierarchyColumn(String propertyName)
  
  Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).
  Resets columns and their order based on bean properties.
  This is a shortcut for removing all columns and then calling Grid.addColumn(String) for each property except hierarchy column in the bean and addHierarchyColumn(String) for the given propertyName.
  Previous column order is preserved.
  You can add columns for nested properties with dot notation, eg. "property.nestedProperty"
  Note that this also resets the headers and footers.
  
  Parameters:
  
  propertyName - a target hierarchy column property name
  
  Returns:
  
  the created hierarchy column
- setHierarchyColumn
  
  public Grid.Column<T> setHierarchyColumn(String propertyName, ValueProvider<T,?> valueProvider)
  
  Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).
  Resets columns and their order based on bean properties.
  This is a shortcut for removing all columns and then calling Grid.addColumn(String) for each property except hierarchy column in the bean and addHierarchyColumn(String) or addHierarchyColumn(ValueProvider) for the given propertyName.
  Previous column order is preserved.
  You can add columns for nested properties with dot notation, eg. "property.nestedProperty"
  Note that this also resets the headers and footers.
  
  Parameters:
  
  propertyName - a target hierarchy column property name
  
  valueProvider - optional value provider
  
  Returns:
  
  the created hierarchy column
- setColumns
  
  public Grid.Column<T> setColumns(String hierarchyPropertyName, ValueProvider<T,?> valueProvider, Collection<String> propertyNames)
  
  Note: This method can only be used for a TreeGrid created from a bean type with TreeGrid(Class).
  Sets the columns and their order based on the given properties.
  This is a shortcut for removing all columns and then calling Grid.addColumn(String) for each property except hierarchy property in the bean and addHierarchyColumn(String) for the given hierarchyPropertyName.
  You can add columns for nested properties with dot notation, eg. "property.nestedProperty"
  Note that this also resets the headers and footers.
  
  Parameters:
  
  hierarchyPropertyName - a target hierarchy column property name
  
  valueProvider - optional value provider
  
  propertyNames - set of properties to create columns for. Including given hierarchyPropertyName
  
  Returns:
  
  the hierarchy column
- expand
  
  public void expand(T... items)
  
  Expands the given items.
  If an item is currently expanded, does nothing. If an item does not have any children, does nothing.
  
  Parameters:
  
  items - the items to expand
- expand
  
  public void expand(Collection<T> items)
  
  Expands the given items.
  If an item is currently expanded, does nothing. If an item does not have any children, does nothing.
  
  Parameters:
  
  items - the items to expand
- expand
  
  protected void expand(Collection<T> items, boolean userOriginated)
  
  Expands the given items.
  
  Parameters:
  
  items - the items to expand
  
  userOriginated - true if a ExpandEvent triggered by this operation is user originated, false otherwise.
- expandRecursively
  
  public void expandRecursively(Stream<T> items, int depth)
  
  Expands the given items and their children recursively until the given depth.
  depth describes the maximum distance between a given item and its descendant, meaning that expandRecursively(items, 0) expands only the given items while expandRecursively(items, 2) expands the given items as well as their children and grandchildren.
  This method will not fire events for expanded nodes.
  
  Parameters:
  
  items - the items to expand recursively
  
  depth - the maximum depth of recursion
  
  Since:
  
  8.4
- expandRecursively
  
  public void expandRecursively(Collection<T> items, int depth)
  
  Expands the given items and their children recursively until the given depth.
  depth describes the maximum distance between a given item and its descendant, meaning that expandRecursively(items, 0) expands only the given items while expandRecursively(items, 2) expands the given items as well as their children and grandchildren.
  This method will not fire events for expanded nodes.
  
  Parameters:
  
  items - the items to expand recursively
  
  depth - the maximum depth of recursion
  
  Since:
  
  8.4
- collapse
  
  public void collapse(T... items)
  
  Collapse the given items.
  For items that are already collapsed, does nothing.
  
  Parameters:
  
  items - the collection of items to collapse
- collapse
  
  public void collapse(Collection<T> items)
  
  Collapse the given items.
  For items that are already collapsed, does nothing.
  
  Parameters:
  
  items - the collection of items to collapse
- collapse
  
  protected void collapse(Collection<T> items, boolean userOriginated)
  
  Collapse the given items.
  
  Parameters:
  
  items - the collection of items to collapse
  
  userOriginated - true if a CollapseEvent triggered by this operation is user originated, false otherwise.
- collapseRecursively
  
  public void collapseRecursively(Stream<T> items, int depth)
  
  Collapse the given items and their children recursively until the given depth.
  depth describes the maximum distance between a given item and its descendant, meaning that collapseRecursively(items, 0) collapses only the given items while collapseRecursively(items, 2) collapses the given items as well as their children and grandchildren.
  This method will not fire events for collapsed nodes.
  
  Parameters:
  
  items - the items to collapse recursively
  
  depth - the maximum depth of recursion
  
  Since:
  
  8.4
- collapseRecursively
  
  public void collapseRecursively(Collection<T> items, int depth)
  
  Collapse the given items and their children recursively until the given depth.
  depth describes the maximum distance between a given item and its descendant, meaning that collapseRecursively(items, 0) collapses only the given items while collapseRecursively(items, 2) collapses the given items as well as their children and grandchildren.
  This method will not fire events for collapsed nodes.
  
  Parameters:
  
  items - the items to collapse recursively
  
  depth - the maximum depth of recursion
  
  Since:
  
  8.4
- getItemsWithChildrenRecursively
  
  protected Collection<T> getItemsWithChildrenRecursively(Collection<T> items, int depth)
  
  Gets given items and their children recursively until the given depth.
  depth describes the maximum distance between a given item and its descendant, meaning that getItemsWithChildrenRecursively(items, 0) gets only the given items while getItemsWithChildrenRecursively(items, 2) gets the given items as well as their children and grandchildren.
  
  Parameters:
  
  items - the items to expand recursively
  
  depth - the maximum depth of recursion
  
  Returns:
  
  collection of given items and their children recursively until the given depth
- isExpanded
  
  public boolean isExpanded(T item)
  
  Returns whether a given item is expanded or collapsed.
  
  Parameters:
  
  item - the item to check
  
  Returns:
  
  true if the item is expanded, false if collapsed
- getDataCommunicator
  
  public HierarchicalDataCommunicator<T> getDataCommunicator()
  
  Description copied from class: Grid
  
  Returns the data communicator of this Grid.
  
  Overrides:
  
  getDataCommunicator in class Grid<T>
  
  Returns:
  
  the data communicator, not null
- getDataProvider
  
  public HierarchicalDataProvider<T,SerializablePredicate<T>> getDataProvider()
  
  Description copied from class: Grid
  
  Returns the data provider of this grid.
  To get information and control over the items in the grid, use either Grid.getListDataView() or Grid.getLazyDataView() instead.
  
  Specified by:
  
  getDataProvider in interface HasHierarchicalDataProvider<T>
  
  Overrides:
  
  getDataProvider in class Grid<T>
  
  Returns:
  
  the data provider of this grid, not null
- scrollToIndex
  
  public void scrollToIndex(int rowIndex)
  
  Scrolls to the index of an item in the root level of the tree. To scroll to a nested item, use scrollToIndex(int...).
  Scrolls so that the row is shown at the start of the visible area whenever possible.
  If the index parameter exceeds current item set size the grid will scroll to the end.
  Overrides:
  
  scrollToIndex in class Grid<T>
  
  Parameters:
  
  rowIndex - zero based index of the item in the root level of the tree
  
  See Also:
  
  scrollToIndex(int...)
- scrollToIndex
  
  public void scrollToIndex(int... indexes)
  
  Scrolls to a nested item within the tree.
  The `indexes` parameter can be either a single number or multiple numbers. The grid will first try to scroll to the item at the first index in the root level of the tree. In case the item at the first index is expanded, the grid will then try scroll to the item at the second index within the children of the expanded first item, and so on. Each given index points to a child of the item at the previous index.
  Parameters:
  
  indexes - zero based row indexes to scroll to
  
  See Also:
  
  scrollToIndex(int)
- scrollToEnd
  
  public void scrollToEnd()
  
  Description copied from class: Grid
  
  Scrolls to the last data row of the grid.
  
  Overrides:
  
  scrollToEnd in class Grid<T>