TreeList.UnselectCells(TreeListNode, TreeListColumn, TreeListNode, TreeListColumn) Method

Discards selection of the specified range of cells.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v24.1.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList

Declaration

C#

public void UnselectCells(
    TreeListNode startNode,
    TreeListColumn startColumn,
    TreeListNode endNode,
    TreeListColumn endColumn
)

VB.NET

Public Sub UnselectCells(
    startNode As TreeListNode,
    startColumn As TreeListColumn,
    endNode As TreeListNode,
    endColumn As TreeListColumn
)

Parameters

Name	Type	Description
startNode	TreeListNode	A node containing the cell that specifies the starting point of the range to unselect.
startColumn	TreeListColumn	A column containing the cell that specifies the starting point of the range to unselect.
endNode	TreeListNode	A node containing the cell that specifies the end point of the range to unselect.
endColumn	TreeListColumn	A column containing the cell that specifies the end point of the range to unselect.

Remarks

The UnselectCells method discards the selection of multiple cells in the specified range. The start and end points of the range are specified using the cells located at the intersection of the nodes (rows) and columns passed as parameters. To select cells, use the TreeList.SelectCell or TreeList.SelectCells method.

The code snippet below shows how to unselect a particular range of cells in the TreeList using the UnselectCells method.

C#

treeList1.UnselectCells(treeList1.Nodes[0].Nodes[0], treeList1.Columns[1], treeList1.Nodes[0].Nodes[1], treeList1.Columns[2]);

VB.NET

treeList1.UnselectCells(treeList1.Nodes[0].Nodes[0], treeList1.Columns[1], treeList1.Nodes[0].Nodes[1], treeList1.Columns[2])

After the selection is changed, the TreeList.SelectionChanged event is raised.

Note

The UnselectCells method is not in effect if multiple cell selection is disabled. This mode can be enabled by setting the TreeListOptionsSelection.MultiSelect property to true and the TreeListOptionsSelection.MultiSelectMode property to CellSelect.