WinForms › Tree List View › BinaryTreeListViewNode

BinaryTreeListViewNode

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.TreeControls

A special/custom implementation of DataGridViewRow that paints and functions as though it was a tree node.

public class BinaryTreeListViewNode : DataGridViewRow

Inherits from / implements: DataGridViewRow

Members at a glance

`BinaryTreeListViewNode`	Constructs a new instance of `BinaryTreeListViewNode` object.
`BinaryTreeListViewCellInfo`	Gets or sets the node specific tree cell information for rendering the `BinaryTreeListViewCell` for this node instance.
`CellInfoCheckStatus`	Gets or sets the status of whether the checkbox/radio button is enabled for this node instance. Only nodes that do not have any children nodes, can have radio button enabled on them.
`Cells`	Gets the cells collection for this instance of node.
`CollapseImage`	Gets or sets the image that is to be used for displaying as glyph for the "collapse" state of nodes.
`ExpandImage`	Gets or sets the image that is to be used for displaying as glyph for the "expand" state of nodes.
`HasChildren`	Gets as to whether this instance of node has any child node(s).
`Image`	Gets or sets the `Image` for this node instance.
`Index`	Gets the index of this instance of the node (from within the `BinaryTreeListViewNodesCollection` that this node belongs to).
`IsFirstSibling`	Gets whether the current node is the first sibling, as regards the owning parent node.
`IsLastSibling`	Gets whether the current node is the last sibling, as regards the owning parent node.
`NodeIndex`	Gets the index of this instance of the node (as is relevant to this instance in the base DataGridView instance).
`Nodes`	Gets the child nodes collection for this instance of node.
`ParentNode`	Gets the associated parent node for this given instance of node.
`ShowNodeImage`	Gets or sets whether to show the associated node image `Image` for this node instance.
`Clone`	Creates a copy of this BinaryTreeListViewNode, carrying across every setting this type adds to the base implementation.
`CloneWithCellsData`	Returns a fully cloned node instance, along with the node's cell data.
`Collapse`	A helper method to let programatically collapse a given node (if it is currently in expanded mode).
`Collapse`	A helper method to let programatically collapse a given node (if it is currently in expanded mode), including its children.
`CreateCellsInstance`	Creates the cell collection for this row. Overridden so the row starts out with this control's own cell types.
`Expand`	A helper method to let programatically expand a given node (if it is currently in collapsed mode, and if it has any children).
`Expand`	A helper method to let programatically expand a given node (if it is currently in collapsed mode, and if it has any children).
`ToString`	Overridden implementation of the `ToString()`, to return something useful for this object.

Constructors

BinaryTreeListViewNode

public BinaryTreeListViewNode()

Constructs a new instance of BinaryTreeListViewNode object.

Properties

BinaryTreeListViewCellInfo

public BinaryTreeListViewCellInfo BinaryTreeListViewCellInfo

Gets or sets the node specific tree cell information for rendering the BinaryTreeListViewCell for this node instance.

CellInfoCheckStatus

public CellInfoCheckStatus CellInfoCheckStatus

Gets or sets the status of whether the checkbox/radio button is enabled for this node instance. Only nodes that do not have any children nodes, can have radio button enabled on them.

Note that if the node is set to a valid checkbox/radio button enabled state, any image associated with the node will not be displayed. ONly the check box / radio button will be displayed instead.
The next version release of this control will allow for both image and checkbox/radio button to be enabled for a given node.

Cells

public new DataGridViewCellCollection Cells

Gets the cells collection for this instance of node.

CollapseImage

public Image CollapseImage

Gets or sets the image that is to be used for displaying as glyph for the "collapse" state of nodes.

ExpandImage

public Image ExpandImage

Gets or sets the image that is to be used for displaying as glyph for the "expand" state of nodes.

HasChildren

public bool HasChildren

Gets as to whether this instance of node has any child node(s).

Image

public Image Image

Gets or sets the Image for this node instance.

Note that you can also set an image that is applicable across all nodes in the control, using the NodeImage property.

Index

public new int Index

Gets the index of this instance of the node (from within the BinaryTreeListViewNodesCollection that this node belongs to).

Also please refer to the other related property NodeIndex when wanting to work with this property.

IsFirstSibling

public bool IsFirstSibling

Gets whether the current node is the first sibling, as regards the owning parent node.

IsLastSibling

public bool IsLastSibling

Gets whether the current node is the last sibling, as regards the owning parent node.

NodeIndex

public int NodeIndex

Gets the index of this instance of the node (as is relevant to this instance in the base DataGridView instance).

Use this property when you want to work with the exact node / row that is in the datagridview.
If you want to work with the node that is logically located inside the hierarchical mode in the control's nodes collection, then use the other property Index.

Nodes

public BinaryTreeListViewNodesCollection Nodes

Gets the child nodes collection for this instance of node.

ParentNode

public BinaryTreeListViewNode ParentNode

Gets the associated parent node for this given instance of node.

ShowNodeImage

public bool ShowNodeImage

Gets or sets whether to show the associated node image Image for this node instance.

Methods

Clone

public override object Clone()

Creates a copy of this BinaryTreeListViewNode, carrying across every setting this type adds to the base implementation.

CloneWithCellsData

public BinaryTreeListViewNode CloneWithCellsData()

Returns a fully cloned node instance, along with the node's cell data.

Note that this clones only the node instance, not its children too.

Collapse

public bool Collapse()

A helper method to let programatically collapse a given node (if it is currently in expanded mode).

Collapse

public bool Collapse(bool performDeepCollapse)

A helper method to let programatically collapse a given node (if it is currently in expanded mode), including its children.

CreateCellsInstance

protected override DataGridViewCellCollection CreateCellsInstance()

Creates the cell collection for this row. Overridden so the row starts out with this control's own cell types.

Expand

public bool Expand()

A helper method to let programatically expand a given node (if it is currently in collapsed mode, and if it has any children).

Expand

public bool Expand(bool performDeepExpansion)

A helper method to let programatically expand a given node (if it is currently in collapsed mode, and if it has any children).

ToString

public override string ToString()

Overridden implementation of the ToString(), to return something useful for this object.