[]
        
(Showing Draft Content)

C1.Win.TreeView.C1TreeView

C1TreeView Class

Control which manages the hierarchical data structures and displays them in a tree structure that has items that can expand and collapse.

Namespace: C1.Win.TreeView
Assembly: C1.Win.TreeView.8.dll
Syntax
[ToolboxBitmap(typeof(C1TreeView), "C1TreeView.png")]
[Docking(DockingBehavior.Ask)]
public class C1TreeView : XView, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IView, ISupportSuperTooltip, ISupportUia, ISupportInitialize

Constructors

Name Description
C1TreeView()

Initializes a new instance of a C1TreeView class.

Properties

Name Description
AllowEditing

Gets or sets whether the user is allowed to edit treeview contents.

AllowUserToResizeColumns

Gets or sets whether the user is allowed to resize columns of treeview control.

AutoCheckChildNodes

Gets or sets a value indicating whether auto check child nodes when parent node is changed checked state.

BindingInfo

Contains information about a data binding.

BorderStyle

Gets or sets the BorderStyle value determining the type of border around the control.

ButtonImageList

Gets the image list that is used to indicate the state of expand buttons.

CanSelectHeader

Gets or sets a value indicating whether the column header can be selected or not.

CheckBoxes

Gets or sets a value indicating whether check boxes should be visible or not.

CheckImageList

Gets the image list that is used to indicate the state of the C1TreeView and its nodes.

Columns

The columns for display data of nodes in the tree view control.

ContextMenuStrip
DefaultSize
EditMode

Gets or sets a value specifying how a user starts cell editing in the C1TreeView control.

EnableDragDrop

Gets or sets a value indicating whether a simple drag and drop in the tree should be enable or not.

ExpandButtonBehavior

Gets or sets a value that specifies the behavior of the C1TreeView when the expand button is clicked.

ExtendLastColumn

Gets or sets whether the last column should be extended to fill the control.

HeaderCheckBox

Contains information about the C1TreeColumn header CheckBox.

ImageList

Gets or sets the image list used to provide images to show on the tree nodes.

IsFocusSynchronizedWithSelection

Gets or sets a value indicating whether the C1TreeView should change a selected node by up or down keys or not.

IsRtlScrollingSupported

Gets a value determining behavior of scroll in rtl mode.

MoveDownByEnter

Gets or sets a value indicating whether the focus can move down when the Enter button is pressed.

Nodes

The root nodes in the tree view control.

RightClickSelect

Gets or sets a value indicating whether a node can be selected by right click or not.

ScrollOnMouseClick

Gets or sets whether to scroll the node cell when it gets focus by mouse click.

SelectedNodes

Gets selected nodes of the tree view control.

SelectionMode

Gets or sets a value indicating selection method of nodes in the tree view control.

SelectionModifier

Gets or sets a value indicating whether how to select node for Multi and MultiSibling modes.

ShowColumnHeaders

Gets or sets a value indicating whether column headers are shown in the tree view control.

Site
Styles

Gets or sets the style of TreeView.

ToStringPlaceHolder

Gets a value of placeholder for display value of ToString method of node value.

Methods

Name Description
BeginEdit()

Begins the edit of treeview cell.

BeginInit()
BeginUpdate()

Suspends painting during long update operations.

CheckAll()

Checks all nodes in the tree view control.

CollapseAll()

Collapses all the nodes in the tree view control.

CreateAccessibilityInstance()

Returns the custom AccessibleObject for the C1TreeView control.

Dispose(bool)

Releases all resources used by the control.

EndEdit(bool)

Ends the edit of treeview cell.

EndInit()
EndUpdate()

Restores painting after long update operations.

ExpandAll()

Expands all nodes in the tree view control.

FocusCell(C1TreeNode, int)

Sets focus to a node cell.

GetAccessibilityObjectById(int)

Retrieves the specified AccessibleObject.

GetColumnPreferredWidth(C1TreeColumn)

Calculates the minimum width of the C1TreeColumn that will fit the currently displayed content.

GetColumnPreferredWidth(int)

Calculates the minimum width of the C1TreeColumn that will fit the currently displayed content.

GetFocusedColumnIndex()

Gets a column index of focused cell.

GetFocusedNode()

Gets a node that contains the focused cell.

GetNodeAtPoint(Point)

Gets the node located at the specified point of client area.

GetTopNode()

Returns the first visible C1TreeNode in the C1TreeView.

IsInputKey(Keys)

Determines whether the specified key is a regular input key or a special key that requires preprocessing.

OnApplyNodeCellStyles(C1TreeViewNodeCellStylesEventArgs)

Fires the ApplyNodeCellStyles event.

OnApplyNodeCellToolTipText(C1TreeViewToolTipTextEventArgs)

Fires the ApplyNodeCellToolTipText event.

OnApplyNodeStyles(C1TreeViewNodeStylesEventArgs)

Fires the ApplyNodeStyles event.

OnBoundItemChanged(C1TreeViewEventArgs)

Fires the BoundItemChanged event.

OnCellBeginEdit(C1TreeViewNodeCellCancelEventArgs)

Fires the CellBeginEdit event.

OnCellEndEdit(C1TreeViewNodeCellEventArgs)

Fires the CellEndEdit event.

OnCheckStateChanged(C1TreeViewEventArgs)

Fires the CheckStateChanged event.

OnCheckStateChanging(C1TreeViewCancelEventArgs)

Fires the CheckStateChanging event.

OnCollapsed(C1TreeViewEventArgs)

Fires the Collapsed event.

OnCollapsing(C1TreeViewCancelEventArgs)

Fires the Collapsing event.

OnColumnHeaderMouseClick(C1TreeViewColumnMouseEventArgs)

Fires the ColumnHeaderMouseClick event.

OnCursorChanged(EventArgs)
OnDataBindingComplete(EventArgs)

Fires the DataBindingComplete event.

OnDragDrop(DragEventArgs)
OnDragEnter(DragEventArgs)
OnDragLeave(EventArgs)
OnDragOver(DragEventArgs)
OnEnabledChanged(EventArgs)
OnExpanded(C1TreeViewEventArgs)

Fires the Expanded event.

OnExpanding(C1TreeViewCancelEventArgs)

Fires the Expanding event.

OnGotFocus(EventArgs)

Raises the GotFocus event.

OnHeaderCheckStateChanged(EventArgs)

Fires the HeaderCheckStateChanged event.

OnHeaderCheckStateChanging(CancelEventArgs)

Fires the HeaderCheckStateChanging event.

OnItemDrag(C1TreeViewItemDragEventArgs)

Fires the ItemDrag event.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

OnLeave(EventArgs)

Raises the Leave event.

OnLostFocus(EventArgs)
OnMouseDoubleClick(MouseEventArgs)
OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

OnMouseWheel(MouseEventArgs)

Raises the MouseWheel event.

OnMultipleSelectionChanged(EventArgs)

Fires the MultipleSelectionChanged event.

OnNodeCheckBoxClick(C1TreeViewCheckBoxEventArgs)

Fires the NodeCheckBoxClick event.

OnNodeEnabledChanged(C1TreeViewEventArgs)

Fires the NodeEnabledChanged event.

OnPaint(PaintEventArgs)

Raises the Paint event.

OnRightToLeftChanged(EventArgs)
OnScroll(ScrollBars)

Override this method to get notifications when the control scrolls.

OnScrollPositionChanged(EventArgs)

Fires the ScrollPositionChanged event.

OnSelectionChanged(C1TreeViewEventArgs)

Fires the SelectionChanged event.

OnSelectionChanging(C1TreeViewCancelEventArgs)

Fires the SelectionChanging event.

OnSizeChanged(EventArgs)

This member overrides OnSizeChanged(EventArgs).

OnStylesChanged(EventArgs)

Fires the StylesChanged event.

RaiseApplyNodeCellStyles(C1TreeNode, int)

Raises the ApplyNodeCellStyles event.

RaiseApplyNodeStyles(C1TreeNode)

Raises the ApplyNodeStyles event.

RaiseKeyDown(KeyEventArgs)

Raises the KeyDown event.

ReadXml(Stream)

Loads the treview from an Xml document.

ReadXml(TextReader)

Loads the treview from an Xml document.

ReadXml(string)

Loads the treview from an Xml document.

ReadXml(XmlDocument)

Loads the treview from an Xml document.

ReadXml(XmlNode)

Loads the treview from an Xml document.

ReadXml(XmlReader)

Loads the treview from an Xml document.

RescaleConstantsForDpi(int, int)
ResetButtonImageList()

Resets the ButtonImageList property to its default value.

ResetCheckImageList()

Resets the CheckImageList property to its default value.

ResetNodeCellStyles(C1TreeNode, int)

Resets the node cell styles.

ResetNodeStyles(C1TreeNode)

Resets the node styles.

ResetStyles()

Resets the Styles property to its default value.

ScrollToNode(C1TreeNode, bool, bool)

Scrolls the C1TreeView to a specific node.

Search(string, int, ComparisonType, bool, StringComparison)

Searches and shows the C1TreeNode containing the specified string.

SearchAll(string, int, ComparisonType, StringComparison)

Searches and shows all nodes containing the specified string.

SetDefaultStyles(TreeViewStyles)

Sets default style for C1TreeView.

ShouldSerializeButtonImageList()

Returns true if this ButtonImageList property has changed; otherwise, returns false.

ShouldSerializeCheckImageList()

Returns true if this CheckImageList property has changed; otherwise, returns false.

ShouldSerializeStyles()
ShowAboutBox()

Shows the About Box for an instance of C1TreeView.

UncheckAll()

Unchecks all nodes in the tree view control.

WriteXml(Stream, bool, bool)

Saves the treeview contents to an Xml document.

WriteXml(TextWriter, bool, bool)

Saves the treeview contents to an Xml document.

WriteXml(string, bool, bool)

Saves the treeview contents to an Xml document.

WriteXml(XmlTextWriter, bool, bool)

Saves the treeview contents to an Xml document.

Events

Name Description
ApplyNodeCellStyles

Occurs before applying styles to a cell of tree node.

ApplyNodeCellToolTipText

Occurs before displaying tree node tooltip.

ApplyNodeStyles

Occurs before applying styles to a tree node.

BeforeContextMenuShow

Occurs before the context menu is shown.

BoundItemChanged

Occurs when a bound item changed.

CellBeginEdit

Occurs when the selected cell enters edit mode.

CellEndEdit

Occurs when the selected cell exits edit mode.

CheckStateChanged

Occurs after the tree node changed the checked state.

CheckStateChanging

Occurs before the tree node checkbox is checked. Allows to cancel the change.

Collapsed

Occurs after the tree node is collapsed.

Collapsing

Occurs before the tree node is collapsed. Allows to cancel the change.

ColumnHeaderMouseClick

Occurs when the user clicks a column header.

DataBindingComplete

Occurs after a data-binding operation has finished.

Expanded

Occurs after the tree node is expanded.

Expanding

Occurs before the tree node is expanded. Allows to cancel the change.

HeaderCheckStateChanged

Occurs after the tree column header checkbox is checked.

HeaderCheckStateChanging

Occurs before the tree column header checkbox is checked. Allows to cancel the change.

ItemDrag

Occurs when the node is dragged.

MultipleSelectionChanged

Occurs when one or more tree nodes changed the selected state in one action.

NodeCheckBoxClick

Occurs when the user clicks a node checkbox.

NodeEnabledChanged

Occurs after the tree node changed the enabled state.

ScrollPositionChanged

Occurs when the ScrollPosition property was changed.

SelectionChanged

Occurs when tree node changed the selected state.

SelectionChanging

Occurs when the tree node is being changed selected state. Allows to cancel the change.

StylesChanged

Occurs when the tree styles changed.