RadTreeView
Represents a hierarchical tree view control that displays a collection of labeled items in a tree structure. Each item is represented by a RadTreeNode and can contain child nodes, images, and custom content. The control supports data binding, drag-and-drop operations, context menus, and various selection modes.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Data Controls")]
[ComplexBindingProperties("DataSource", "DataMember")]
[LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "SelectedNode")]
[Docking(DockingBehavior.Ask)]
public class RadTreeView : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IFilterable, ISupportRootUIAutomationInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadTreeView...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadTreeView class with default settings. Sets up event handlers and prepares the tree view for operation.
public RadTreeView()Properties
Gets the active editor currently being used for editing a tree node. Returns null if no node is currently being edited.
public IInputEditor ActiveEditor { get; }Gets or sets a value indicating whether adding new tree nodes is allowed. When enabled, users can create new nodes through the user interface.
public virtual bool AllowAdd { get; set; }Gets or sets a value indicating whether tree nodes can have different heights. When enabled, individual nodes can be sized independently based on their content.
[Browsable(true)]
public virtual bool AllowArbitraryItemHeight { get; set; }Gets or sets a value indicating whether the default context menu is enabled for the tree view. When enabled, a built-in context menu with common operations is available.
public bool AllowDefaultContextMenu { get; set; }Gets or sets a value indicating whether drag and drop operations with tree view nodes are enabled. When enabled, users can drag nodes to reorder or move them within the tree structure.
public virtual bool AllowDragDrop { get; set; }Gets or sets a value indicating whether node text editing is allowed. When enabled, users can edit node text by clicking on selected nodes or pressing F2.
public virtual bool AllowEdit { get; set; }Gets or sets a value indicating whether animation of expand/collapse buttons is enabled. When enabled, the plus/minus buttons will be animated during expand/collapse operations.
public bool AllowPlusMinusAnimation { get; set; }Gets or sets a value indicating whether removing tree nodes is allowed. When enabled, users can delete nodes through the user interface.
public virtual bool AllowRemove { get; set; }Gets or sets a value indicating whether child nodes should be automatically checked when the tree view is in tri-state mode. When enabled, checking a parent node will automatically check all its child nodes.
public virtual bool AutoCheckChildNodes { get; set; }Gets or sets a value indicating whether the control automatically provides scrollbars when content exceeds the visible area. This property controls the automatic display of scrollbars in the tree view when needed.
[Browsable(false)]
public override bool AutoScroll { get; set; }Overrides:
Gets or sets a value indicating whether checkboxes are displayed beside the tree nodes. When enabled, users can check/uncheck nodes independently of selection.
public virtual bool CheckBoxes { get; set; }Gets or sets the property in the data source that determines the checked state of tree node checkboxes. This property is used when CheckBoxes is enabled and the tree view is data-bound.
public virtual string CheckedMember { get; set; }Gets the collection of tree nodes that are currently checked. This collection is populated when CheckBoxes is enabled.
[Browsable(false)]
public virtual CheckedTreeNodeCollection CheckedNodes { get; }Gets or sets the property in the data source that contains child node data for hierarchical binding. This property is used for self-referencing data sources to establish parent-child relationships.
public virtual string ChildMember { get; set; }Gets or sets the ContextMenuStrip associated with this control.
[Browsable(false)]
public override ContextMenuStrip ContextMenuStrip { get; set; }Overrides:
Gets or sets the name of the data member in the data source for which the RadTreeView is displaying data. This property specifies which table or list within the data source to bind to.
[Browsable(true)]
public virtual string DataMember { get; set; }Gets or sets the data source that provides data for the RadTreeView. This can be any object that implements IList or IListSource.
public virtual object DataSource { get; set; }Implements:
Gets the default size for the tree view control.
protected override Size DefaultSize { get; }Overrides:
Gets or sets the property to display for each tree node when the tree view is data-bound. This property specifies which field from the data source should be used for node text.
public virtual string DisplayMember { get; set; }Gets or sets the color of the drop hint displayed during drag and drop operations. The drop hint provides visual feedback to assist users in understanding where items can be dropped.
public Color DropHintColor { get; set; }Gets or sets a value indicating whether deferred scrolling is enabled for improved performance. When enabled, scrolling updates are deferred until the scrolling operation completes.
[Browsable(false)]
public bool EnableDeferredScrolling { get; set; }Gets or sets a value indicating whether kinetic scrolling is enabled for touch-based interactions. When enabled, scrolling continues with momentum after the user stops touching, providing a natural scrolling experience.
[Browsable(true)]
public bool EnableKineticScrolling { get; set; }Gets or sets a value indicating whether the UI Automation functionality is enabled or disabled for this control.
public override bool EnableUIAutomation { get; set; }Overrides:
Implements:
Gets or sets the type of animation used when expanding or collapsing tree nodes. This property controls the visual effect applied during node expand/collapse operations.
public ExpandAnimation ExpandAnimation { get; set; }Gets or sets the expand mode that controls how nodes can be expanded. This property determines whether single or multiple nodes can be expanded simultaneously.
[Browsable(false)]
public ExpandMode ExpandMode { get; set; }Gets or sets the filter applied to tree nodes. This property allows filtering of tree nodes based on custom criteria.
[Browsable(false)]
public virtual object Filter { get; set; }Gets the collection of filter descriptors applied to the tree view. These descriptors define the filtering criteria for tree nodes.
[Browsable(false)]
public virtual FilterDescriptorCollection FilterDescriptors { get; }Implements:
Gets or sets the string comparer used for keyboard navigation functionality. This comparer determines how text matching is performed during keyboard search.
[Browsable(false)]
public virtual IFindStringComparer FindStringComparer { get; set; }Gets or sets a value indicating whether the selection highlight spans the full width of the tree view. When enabled, the selected node highlight extends across the entire width of the control.
public virtual bool FullRowSelect { get; set; }Gets or sets a value indicating whether the selection highlight is hidden when the control loses focus. When enabled, selected nodes remain visually highlighted even when the tree view is not focused.
public virtual bool HideSelection { get; set; }Gets or sets a value indicating whether hot tracking is enabled for tree nodes. When enabled, nodes are highlighted when the mouse pointer hovers over them.
public virtual bool HotTracking { get; set; }Gets the horizontal scroll bar element of the tree view control. This scroll bar appears when the tree content extends beyond the control's width.
[Browsable(false)]
public RadScrollBarElement HScrollBar { get; }Gets or sets the default image index for tree nodes in the associated ImageList. This value is used for nodes that don't have a specific image index assigned.
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.2.702.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndex { get; set; }Gets or sets the default image key for tree nodes in the associated ImageList. This value is used for nodes that don't have a specific image key assigned.
[RelatedImageList("ImageList")]
[TypeConverter(typeof(ImageKeyConverter))]
public virtual string ImageKey { get; set; }Gets a value indicating whether there is an active editor currently open for editing a tree node. Returns true if a node is currently being edited, false otherwise.
[Browsable(true)]
public bool IsEditing { get; }Gets or sets the height of tree view items in pixels. This property controls the vertical spacing of tree nodes.
[Browsable(false)]
public virtual int ItemHeight { get; set; }Gets or sets a value indicating whether keyboard search navigation is enabled. When enabled, users can navigate to nodes by typing the first characters of node text.
[Browsable(true)]
public virtual bool KeyboardSearchEnabled { get; set; }Gets or sets the time interval in milliseconds before keyboard search is reset. This determines how long to wait between keystrokes before starting a new search.
[Browsable(true)]
public virtual int KeyboardSearchResetInterval { get; set; }Gets or sets a value indicating whether the tree view loads child node collections in the NodesNeeded event only when parent nodes are expanded. This lazy loading approach improves performance by deferring node loading until actually needed.
[Browsable(false)]
public bool LazyMode { get; set; }Gets or sets the color of the lines connecting parent and child nodes in the tree view. This property is only effective when ShowLines is enabled.
public virtual Color LineColor { get; set; }Gets or sets the style of lines connecting parent and child nodes in the tree view. This property controls the visual appearance of the connecting lines when ShowLines is enabled.
public virtual TreeLineStyle LineStyle { get; set; }Gets or sets the width in pixels of the lines connecting parent and child nodes. This property controls the thickness of the connecting lines when ShowLines is enabled.
public virtual float LineWidth { get; set; }Gets or sets a value indicating whether the user is allowed to select multiple tree nodes at one time. When enabled, users can hold Ctrl or Shift keys to select multiple nodes.
public virtual bool MultiSelect { get; set; }Gets the collection of tree nodes that are assigned to the tree view control. This collection contains all root-level nodes and provides access to the entire tree structure.
[Browsable(true)]
public virtual RadTreeNodeCollection Nodes { get; }Gets or sets the property in the data source that identifies the parent node for hierarchical binding. This property is used for self-referencing data sources to establish parent-child relationships.
public virtual string ParentMember { get; set; }Gets or sets the character used as a separator in the node path. This separator is used when constructing or parsing hierarchical node paths.
public virtual string PathSeparator { get; set; }Gets or sets the opacity animation step for expand/collapse animation. This controls the granularity of the opacity change during node expand/collapse animations.
[Browsable(false)]
public double PlusMinusAnimationStep { get; set; }Gets or sets the RadContextMenu associated with this tree view control. This context menu is displayed when users right-click on the tree view.
public virtual RadContextMenu RadContextMenu { get; set; }Gets the collection of relation bindings that define how hierarchical data relationships are established. This collection contains data binding settings for related data in master-detail scenarios.
[Browsable(true)]
public RelationBindingCollection RelationBindings { get; }Gets or sets the currently selected tree node. Returns null if no node is selected.
[Browsable(false)]
public virtual RadTreeNode SelectedNode { get; set; }Gets the collection of currently selected tree nodes. This collection contains all selected nodes when MultiSelect is enabled.
[Browsable(false)]
public virtual SelectedTreeNodeCollection SelectedNodes { get; }Gets or sets a value indicating whether drag hints are displayed when dragging items. When enabled, visual feedback shows the item being dragged during drag and drop operations.
public bool ShowDragHint { get; set; }Gets or sets a value indicating whether drop hints are displayed during drag and drop operations. When enabled, visual indicators show where items can be dropped in the tree hierarchy.
public bool ShowDropHint { get; set; }Gets or sets a value indicating whether expand/collapse buttons are shown next to nodes with children. When enabled, plus/minus buttons allow users to expand or collapse parent nodes.
public bool ShowExpandCollapse { get; set; }Gets or sets a value indicating whether lines connecting parent and child nodes are displayed. When enabled, visual lines show the hierarchical relationship between nodes.
public virtual bool ShowLines { get; set; }Gets or sets a value indicating whether tooltips are displayed for tree nodes. When enabled, node tooltips will be shown when hovering over nodes with the mouse.
public bool ShowNodeToolTips { get; set; }Gets or sets a value indicating whether lines are displayed between root-level nodes. When enabled, connecting lines are shown between top-level nodes in the tree view.
public bool ShowRootLines { get; set; }Gets the collection of sort descriptors applied to the tree view. These descriptors define the sorting criteria for tree nodes.
[Browsable(false)]
public SortDescriptorCollection SortDescriptors { get; }Gets or sets the sort order of tree nodes. This property controls how nodes are sorted within each level of the tree hierarchy.
[Browsable(true)]
public SortOrder SortOrder { get; set; }Gets or sets the vertical spacing in pixels between tree nodes. This property controls the gap between adjacent nodes in the tree view.
public int SpacingBetweenNodes { get; set; }Gets or sets the default toggle mode for expanding and collapsing tree nodes. This property determines how users can expand or collapse nodes (single click, double click, etc.).
public virtual ToggleMode ToggleMode { get; set; }Gets or sets a TypeConverter used to convert checkbox toggle states to the underlying data type. This converter is used when binding checkbox states to data source properties.
public virtual TypeConverter ToggleStateConverter { get; set; }Gets the topmost visible tree node in the tree view control. This property returns the first node that is currently visible in the control's view area.
[Browsable(false)]
public RadTreeNode TopNode { get; }Gets or sets the indentation distance in pixels for each level of tree nodes. This controls the horizontal spacing between parent and child nodes.
public int TreeIndent { get; set; }Gets the underlying tree view element that provides the core functionality for the control. This element contains the main logic and rendering capabilities of the tree view.
[Browsable(false)]
public virtual RadTreeViewElement TreeViewElement { get; }Gets or sets the XML representation of the tree view structure. This property allows saving and loading the entire tree structure as XML data.
public string TreeViewXml { get; set; }Gets or sets a value indicating whether tri-state mode is enabled for node checkboxes. When enabled, checkboxes can have three states: checked, unchecked, and indeterminate.
public virtual bool TriStateMode { get; set; }Gets or sets the property in the data source that provides the value for each tree node. This property specifies which field from the data source should be used for node values.
public virtual string ValueMember { get; set; }Gets the number of tree nodes that can be fully visible in the tree view control. This count is based on the current size of the control and the height of the nodes.
[Browsable(false)]
public int VisibleCount { get; }Gets the vertical scroll bar element of the tree view control. This scroll bar appears when the tree content extends beyond the control's height.
[Browsable(false)]
public RadScrollBarElement VScrollBar { get; }Methods
Creates a new tree node and adds it at the location specified by the hierarchical path using a custom path separator. The path is parsed using the specified separator to determine the node hierarchy.
public virtual RadTreeNode AddNodeByPath(string path, string pathSeparator)The hierarchical path where the node should be added.
pathSeparatorstringThe custom path separator to use for parsing the path.
Returns:The newly created RadTreeNode if the operation is successful.
Creates a new tree node and adds it at the location specified by the hierarchical path. The path is parsed using the PathSeparator to determine the node hierarchy.
public virtual RadTreeNode AddNodeByPath(string path)The hierarchical path where the node should be added.
Returns:The newly created RadTreeNode if the operation is successful.
Begins edit mode for the currently selected tree node.
public bool BeginEdit()True if edit mode was successfully started; otherwise, false.
Suspends layout during initialization.
public override void BeginInit()Overrides:
Disables visual updates to the tree view to improve performance during batch operations. Must be paired with a call to EndUpdate().
public void BeginUpdate()Scrolls the tree view to ensure the specified node is visible within the control's display area.
public void BringIntoView(RadTreeNode node)The tree node to bring into view.
Closes the currently active editor and discards any changes made during editing.
public void CancelEdit()Clears the current node selection, deselecting all currently selected nodes.
public virtual void ClearSelection()Collapses all tree nodes in the tree view, hiding all child nodes.
public void CollapseAll()Collapses all nodes in the specified collection, hiding their child nodes.
public void CollapseAll(RadTreeNodeCollection nodes)The collection of nodes to be collapsed.
protected override AccessibleObject CreateAccessibilityInstance()Overrides:
Creates the child elements that make up the tree view control structure. This method instantiates the main RadTreeViewElement and adds it to the parent container.
protected override void CreateChildItems(RadElement parent)The parent RadElement that will contain the child elements.
Overrides:
Creates and returns a new instance of the tree view element that provides the core functionality. This method can be overridden in derived classes to provide custom tree view element implementations.
protected virtual RadTreeViewElement CreateTreeViewElement()A new RadTreeViewElement instance.
Defers refresh operations for the tree view, returning a disposable object that triggers refresh when disposed. This is useful for batching multiple operations while maintaining automatic cleanup.
public virtual IDisposable DeferRefresh()An IDisposable object that triggers refresh when disposed.
Releases the unmanaged resources used by the RadTreeView and optionally releases the managed resources. This method cleans up event handlers and disposes of the context menu if it's the default implementation.
protected override void Dispose(bool disposing)true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides:
Commits any changes and ends the edit operation on the currently edited node.
public bool EndEdit()True if the edit operation was successfully ended; otherwise, false.
Resumes layout.
public override void EndInit()Overrides:
Re-enables visual updates to the tree view after a call to BeginUpdate(). This will refresh the tree view display with any changes made during the update period.
public void EndUpdate()Executes the specified command on the tree view with control over subtree inclusion.
public object Execute(bool includeSubTrees, ICommand command, params object[] settings)True to include subtrees in the command execution; otherwise, false.
commandICommandThe command to execute.
settingsobject[]Optional settings or parameters for the command.
Returns:The result of the command execution, if any.
Executes the specified command on the tree view with optional settings.
Executes a command over an entire subtree starting with the specified node.
public static List<object> ExecuteBatchCommand(RadTreeNode node, int level, ICommand command, params object[] settings)The node form which the execuition starts.
levelintThe level of nodes over which to execute the command. If -1 the entire subtree is traversed.
commandICommandThe command to execute.
settingsobject[]Parameters to pass the command prior to execution.
Returns:List<object>
The results from the batch execution.
Executes a command over an entire subtree starting with the specified node collection. This static method allows batch operations across multiple tree branches.
public static List<object> ExecuteBatchCommand(RadTreeNodeCollection nodes, int level, ICommand command, params object[] settings)The collection of nodes from which execution starts.
levelintThe level of nodes over which to execute the command. If -1, the entire subtree is traversed.
commandICommandThe command to execute on each node.
settingsobject[]Parameters to pass to the command prior to execution.
Returns:List<object>
A list containing the results from the batch execution.
Executes a command over an entire subtree starting with the specified node. This static method returns the first result from the batch execution.
public static object ExecuteScalarCommand(RadTreeNode node, int level, ICommand command, params object[] settings)The node from which execution starts.
levelintThe level of nodes over which to execute the command. If -1, the entire subtree is traversed.
commandICommandThe command to execute on each node.
settingsobject[]Parameters to pass to the command prior to execution.
Returns:The first result from the batch execution.
Expands all tree nodes in the tree view, revealing all child nodes.
public void ExpandAll()Expands all nodes in the specified collection, revealing their child nodes.
public virtual void ExpandAll(RadTreeNodeCollection nodes)The collection of nodes to be expanded.
Searches for the first tree node that matches the specified predicate function.
public RadTreeNode Find(Predicate<RadTreeNode> match)A predicate function that defines the search criteria.
Returns:The first RadTreeNode that matches the predicate, or null if no match is found.
Searches for the first tree node whose text contains the specified string.
public virtual RadTreeNode Find(string text)The text to search for within node text.
Returns:The first RadTreeNode containing the specified text, or null if not found.
Searches for the first tree node that matches the specified search function with a parameter.
public RadTreeNode Find<T>(FindAction<T> match, T arg)A function that defines the search criteria with a parameter.
argTThe argument to pass to the search function.
Returns:The first RadTreeNode that matches the criteria, or null if no match is found.
Searches for all tree nodes that match the specified predicate function.
public RadTreeNode[] FindNodes(Predicate<RadTreeNode> match)A predicate function that defines the search criteria.
Returns:An array of RadTreeNode objects that match the predicate.
Searches for all tree nodes whose text contains the specified string.
public virtual RadTreeNode[] FindNodes(string text)The text to search for within node text.
Returns:An array of RadTreeNode objects containing the specified text.
Searches for all tree nodes that match the specified search function with a parameter.
public RadTreeNode[] FindNodes<T>(FindAction<T> match, T arg)A function that defines the search criteria with a parameter.
argTThe argument to pass to the search function.
Returns:An array of RadTreeNode objects that match the criteria.
Executes the specified action for every tree node in the tree view. The action is applied recursively to all nodes in the tree structure.
public void ForEach(Action<RadTreeNode> action)The action to execute for each tree node.
Retrieves the tree node located at the specified coordinates in client coordinates.
public RadTreeNode GetNodeAt(int x, int y)The X coordinate to evaluate and retrieve the node from.
yintThe Y coordinate to evaluate and retrieve the node from.
Returns:The RadTreeNode at the specified location, or null if no node exists at that location.
Retrieves the tree node located at the specified point in client coordinates.
public RadTreeNode GetNodeAt(Point pt)The point to evaluate and retrieve the node from.
Returns:The RadTreeNode at the specified point, or null if no node exists at that location.
Retrieves the first tree node with the specified name, searching from a specific root node. Searches recursively through the specified root node and its descendants.
public RadTreeNode GetNodeByName(string name, RadTreeNode rootNode)The name of the node to find.
rootNodeRadTreeNodeThe root node to begin the search from.
Returns:The first RadTreeNode with the specified name, or null if not found.
Retrieves the first tree node with the specified name from the entire tree. Searches recursively through all nodes in the tree view.
public RadTreeNode GetNodeByName(string name)The name of the node to find.
Returns:The first RadTreeNode with the specified name, or null if not found.
Retrieves a tree node by following the specified hierarchical path using a custom path separator. The path is parsed using the specified separator to locate the node.
public virtual RadTreeNode GetNodeByPath(string path, string pathSeparator)The hierarchical path to the desired node.
pathSeparatorstringThe custom path separator to use for parsing the path.
Returns:The RadTreeNode at the specified path, or null if not found.
Retrieves a tree node by following the specified hierarchical path. The path is parsed using the current PathSeparator value.
public virtual RadTreeNode GetNodeByPath(string path)The hierarchical path to the desired node.
Returns:The RadTreeNode at the specified path, or null if not found.
Loads tree view structure from an XML reader with support for additional custom types.
Handles the load event and enables pan gesture support for touch interactions. This method is called when the control is loaded and initializes gesture-based navigation.
protected override void OnLoad(Size desiredSize)The desired size for the control.
Overrides:
protected override void OnMouseDoubleClick(MouseEventArgs e)Overrides:
Handles property change notifications and updates the tree view as needed.
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)The property change event arguments.
Overrides:
Processes Windows theme changes and updates the tree view appearance accordingly.
protected override void OnThemeNameChanged(ThemeNameChangedEventArgs e)The theme change event arguments.
Overrides:
protected override void ProcessCodedUIMessage(ref IPCMessage request)Overrides:
Saves the tree view structure to an XML file with support for additional custom types.
Saves the tree view structure to an XML writer with support for additional custom types.
protected virtual void SaveXMLWithWriter(TextWriter writer, params Type[] extraTypes)The text writer to save XML data to.
extraTypesType[]Additional types that should be included in XML serialization.
Selects all tree nodes in the tree view when MultiSelect is enabled.
public virtual void SelectAll()Sets an error message for a specific tree node, typically used for validation feedback.
public void SetError(string text, RadTreeNode radTreeNode)The error message text to display.
radTreeNodeRadTreeNodeThe tree node to associate with the error.
Returns a string representation of this tree view control, including node count information.
public override string ToString()A string that represents the current tree view control.
Overrides:
Removes event handler connections for the tree view control during cleanup. This method unsubscribes from events to prevent memory leaks when the control is disposed.
protected virtual void UnwireEvents()Establishes event handler connections for the tree view control. This method subscribes to essential events like SelectedNodeChanged for proper functionality.
protected virtual void WireEvents()Processes Windows messages for the tree view control, including context menu handling.
protected override void WndProc(ref Message m)The Windows message to process.
Overrides:
Events
Occurs when a context menu is about to be opened for the tree view. This event allows customization of the context menu before it is displayed.
public event TreeViewContextMenuOpeningEventHandler ContextMenuOpeningOccurs when a new tree node is about to be created during data binding or programmatic operations. This event allows customization of node creation and assignment of custom node types.
public event CreateTreeNodeEventHandler CreateNodeOccurs when a new tree node element is about to be created for visual rendering. This event allows customization of the visual element that represents a tree node.
public event CreateTreeNodeElementEventHandler CreateNodeElementOccurs when a data binding error is encountered during tree view operations. This event allows handling and responding to data-related errors gracefully.
public event TreeNodeDataErrorEventHandler DataErrorOccurs after a drag operation has completed successfully. This event is raised when nodes have been moved or copied to their new location.
public event RadTreeView.DragEndedHandler DragEndedOccurs when a drag operation is about to end, allowing cancellation of the drop operation. This event provides an opportunity to validate and potentially cancel the drag operation.
public event RadTreeView.DragEndingHandler DragEndingOccurs when dragged content is positioned over a tree node during a drag operation. This event allows customization of visual feedback and validation of drop targets.
public event EventHandler<RadTreeViewDragCancelEventArgs> DragOverNodeOccurs after a drag operation has begun and the node is being dragged. This event indicates that the drag operation is now active.
public event RadTreeView.DragStartedHandler DragStartedOccurs when a drag operation is about to begin, allowing cancellation of the operation. This event provides an opportunity to prevent certain nodes from being dragged.
public event RadTreeView.DragStartingHandler DragStartingOccurs after a tree node has finished being edited and the changes have been applied. This event provides access to the edited node and the new value.
public event TreeNodeEditedEventHandler EditedOccurs before a tree node enters edit mode for text editing. This event allows validation and cancellation of the editing operation.
public event TreeNodeEditingEventHandler EditingOccurs when the active editor for node editing has been initialized. This event allows customization of the editor after it has been created and configured.
public event TreeNodeEditorInitializedEventHandler EditorInitializedOccurs when the tree view requires an editor for node editing operations. This event allows custom editor selection and configuration for different node types.
[Browsable(true)]
public event RadTreeView.EditorRequiredHandler EditorRequiredOccurs when the user begins dragging a tree node. This event is raised at the start of a drag operation when AllowDragDrop is enabled.
public event RadTreeView.ItemDragHandler ItemDragOccurs after a tree node has been added to the tree view. This event provides access to the newly added node for initialization or logging purposes.
[Browsable(true)]
public event RadTreeView.RadTreeViewEventHandler NodeAddedOccurs before a tree node is added to the tree view, allowing cancellation of the operation. This event provides an opportunity to validate or prevent node addition.
[Browsable(true)]
public event RadTreeView.RadTreeViewCancelEventHandler NodeAddingOccurs after the checked state of a tree node has changed. This event is raised when CheckBoxes is enabled and a node's check state has been modified.
public virtual event TreeNodeCheckedEventHandler NodeCheckedChangedOccurs before the checked state of a tree node changes, allowing cancellation of the operation. This event is raised when CheckBoxes is enabled and a node's check state is about to change.
public virtual event RadTreeView.RadTreeViewCancelEventHandler NodeCheckedChangingOccurs after a tree node has been bound to a data item during data binding operations. This event allows customization of the node after it has been populated with data.
[Browsable(true)]
public event RadTreeView.RadTreeViewEventHandler NodeDataBoundOccurs after a tree node has been expanded or collapsed. This event is raised when the expanded state of a node has been successfully changed.
[Browsable(true)]
public event RadTreeView.TreeViewEventHandler NodeExpandedChangedOccurs before a tree node is expanded or collapsed, allowing cancellation of the operation. This event provides an opportunity to validate or prevent expand/collapse actions.
[Browsable(true)]
public event RadTreeView.RadTreeViewCancelEventHandler NodeExpandedChangingOccurs when a tree node needs to be formatted for display. This event allows customization of node appearance based on state or data.
public event TreeNodeFormattingEventHandler NodeFormattingOccurs when a mouse button is clicked on a tree node. This event provides access to the clicked node and mouse event details.
public event RadTreeView.TreeViewEventHandler NodeMouseClickOccurs when a mouse button is double-clicked on a tree node. This event provides access to the double-clicked node and mouse event details.
public event RadTreeView.TreeViewEventHandler NodeMouseDoubleClickOccurs when the user presses a mouse button while the cursor is over a tree node. This event provides access to the specific node and mouse button information.
public event RadTreeView.TreeViewMouseEventHandler NodeMouseDownOccurs when the mouse cursor enters the area of a tree node. This event is useful for implementing custom hover effects or tooltips.
public event RadTreeView.TreeViewEventHandler NodeMouseEnterOccurs when the mouse cursor hovers over a tree node for an extended period. This event is typically used for displaying detailed tooltips or information.
public event RadTreeView.TreeViewEventHandler NodeMouseHoverOccurs when the mouse cursor leaves the area of a tree node. This event is useful for cleaning up hover effects or hiding tooltips.
public event RadTreeView.TreeViewEventHandler NodeMouseLeaveOccurs when the user moves the mouse cursor within the area of a tree node. This event provides access to the specific node and mouse position information.
public event RadTreeView.TreeViewMouseEventHandler NodeMouseMoveOccurs when the user releases a mouse button while the cursor is over a tree node. This event provides access to the specific node and mouse button information.
public event RadTreeView.TreeViewMouseEventHandler NodeMouseUpOccurs after a tree node has been removed from the tree view. This event provides access to the removed node for cleanup or logging purposes.
[Browsable(true)]
public event RadTreeView.RadTreeViewEventHandler NodeRemovedOccurs before a tree node is removed from the tree view, allowing cancellation of the operation. This event provides an opportunity to validate or prevent node removal.
[Browsable(true)]
public event RadTreeView.RadTreeViewCancelEventHandler NodeRemovingOccurs when child nodes need to be loaded in lazy loading mode. This event is raised when LazyMode is enabled and a node is expanded for the first time.
[Browsable(true)]
public event NodesNeededEventHandler NodesNeededOccurs after a tree node has been selected. This event is raised when the SelectedNode property changes.
public virtual event RadTreeView.RadTreeViewEventHandler SelectedNodeChangedOccurs before a tree node selection changes, allowing cancellation of the selection. This event provides an opportunity to validate and potentially prevent node selection.
public virtual event RadTreeView.RadTreeViewCancelEventHandler SelectedNodeChangingOccurs when the SelectedNodes collection has been modified. This event is raised when nodes are added to or removed from the selection.
public virtual event EventHandler<RadTreeViewEventArgs> SelectedNodesChangedOccurs when all selected nodes have been cleared from the SelectedNodes collection. This event is raised when the selection is programmatically or interactively cleared.
public virtual event EventHandler SelectedNodesClearedOccurs when the tree view needs to determine whether to show an expander for a node in lazy loading mode. This event is raised when LazyMode is enabled and the control needs to display expand indicators.
public event RadTreeView.TreeViewShowExpanderEventHandler ShowExpanderOccurs when editor validation fails during the node editing process. This event is raised when the entered value does not meet validation criteria.
[Browsable(true)]
public event EventHandler ValidationErrorOccurs when the editor has finished editing and the new value has been committed. This event is raised after the node value has been successfully changed.
[Browsable(true)]
public event TreeNodeValueChangedEventHandler ValueChangedOccurs when the editor value is in the process of being changed during node editing. This event allows validation and modification of the value before it is committed.
public event TreeNodeValueChangingEventHandler ValueChangingOccurs when the editor value is being validated during the editing process. This event allows custom validation logic and can prevent invalid values from being accepted.
[Browsable(true)]
public event TreeNodeValidatingEventHandler ValueValidating