Skip to main content

TreeList Events

Displays data as a multi-column tree view. Can be used in either bound or unbound mode. See Tree List for more information.
Name Description
AfterCheckNode Occurs after a node’s check state has been changed by an end-user.
AfterCollapse Fires immediately after a node has been collapsed.
AfterDragNode Fires immediately after a drag-and-drop operation on a node has been successfully completed.
AfterDropNode Fires after a node is dropped.
AfterExpand Fires immediately after a node has been expanded.
AfterFocusNode Fires in response to focus being moved between nodes.
AutoSizeChanged This event is not relevant for this class. Inherited from Control.
BackColorChanged Occurs when the value of the BackColor property changes. Inherited from Control.
BackgroundImageChanged Occurs when the value of the BackgroundImage property changes. Inherited from Control.
BackgroundImageLayoutChanged Occurs when the BackgroundImageLayout property changes. Inherited from Control.
BandPositionChanged Fires after a band changes its position or visibility.
BandWidthChanged Occurs when the band’s width is changed.
BeforeCheckNode Occurs before a node’s check state is changed.
BeforeCollapse Fires before a node is collapsed.
BeforeDragNode Fires when an attempt to drag a node is performed.
BeforeDropNode Fires when a node is about to be dropped, and allows you to cancel the operation.
BeforeExpand Fires before a node is expanded. Allows you to implement dynamic node loading in unbound mode.
BeforeFocusNode Fires before a node is focused.
BeforeLoadLayout Occurs before a layout is restored from storage (a stream, xml file or the system registry).
BindingContextChanged Occurs when the value of the BindingContext property changes. Inherited from Control.
CalcNodeDragImageIndex Enables you to specify a custom image to be displayed in front of nodes during node drag-and-drop.
CalcNodeHeight Allows you to assign custom node height.
CausesValidationChanged Occurs when the value of the CausesValidation property changes. Inherited from Control.
CellValueChanged Fires immediately after a user closes a cell editor with a modified value.
CellValueChanging Fires when an end-user starts to edit a cell value.
ChangeUICues Occurs when the focus or keyboard user interface (UI) cues change. Inherited from Control.
Click Occurs when the control is clicked. Inherited from Control.
ClientSizeChanged Occurs when the value of the ClientSize property changes. Inherited from Control.
ClipboardNodeCopying Fires before a data row, a group row, column headers, or band headers are copied to the clipboard. Allows you to apply a format, change copied data, or skip a data row or header.
ClipboardNodePasting Fires before a node is pasted to the control. Allows you to apply a format, update the pasted data, or skip a data row.
ColumnButtonClick Fires when the column button is clicked.
ColumnChanged Fires immediately after the column collection or an individual column has been modified.
ColumnFilterChanged Occurs when a column’s filter condition is changed.
ColumnPositionChanged Fires when a column is moved, hidden, or shown.
ColumnUnboundExpressionChanged Fires after a column’s TreeListColumn.UnboundExpression property has been changed.
ColumnWidthChanged Fires after a column’s width has been changed.
CompareNodeValues Enables you to implement custom sorting for columns whose TreeListColumn.SortMode property is set to Custom. For versions 17.1 and higher, the CompareNodeValues event is deprecated and replaced with the TreeList.CustomColumnSort event.
ContextMenuChanged Occurs when the value of the ContextMenu property changes. Inherited from Control.
ContextMenuStripChanged Occurs when the value of the ContextMenuStrip property changes. Inherited from Control.
ControlAdded Occurs when a new control is added to the Control.ControlCollection. Inherited from Control.
ControlRemoved Occurs when a control is removed from the Control.ControlCollection. Inherited from Control.
CreateCustomNode Provides the ability to create custom nodes.
CursorChanged Occurs when the value of the Cursor property changes. Inherited from Control.
CustomColumnDisplayText Fires for both bound and unbound Tree List columns and allows you to provide a custom display text for any cell.
CustomColumnSort Allows you to apply custom sorting for those Tree List columns whose TreeListColumn.SortMode is set to Custom.
CustomDrawBandHeader Provides the capability to custom paint band headers.
CustomDrawColumnHeader Provides the ability to custom paint column headers and the column button.
CustomDrawEmptyArea Enables you to custom paint a Tree List’s empty area.
CustomDrawFilterPanel Enables you to custom paint the Filter Panel.
CustomDrawFooter Gives you the ability to perform custom painting of the summary footer.
CustomDrawFooterCell Gives you the ability to perform custom painting of column footer cells.
CustomDrawNodeButton Gives you the ability to perform custom painting of expand buttons.
CustomDrawNodeCell Provides the ability to perform custom painting of node cells.
CustomDrawNodeCheckBox Enables you to manually paint node check boxes.
CustomDrawNodeImages Provides access to a GDI+/DirectX drawing surface and allows you to draw node icons manually.
CustomDrawNodeIndent Enables tree indents to be painted manually.
CustomDrawNodeIndicator Provides the ability to perform custom painting of indicator cells.
CustomDrawNodePreview Allows you to custom paint preview sections.
CustomDrawRow Enables you to paint rows.
CustomDrawRowFooter Provides the ability to perform custom painting of row footers.
CustomDrawRowFooterCell Provides the ability to perform custom painting of row footer cells.
CustomDrawScroll Allows you to draw custom scrollbars, or highlight specific positions on the scrollbars.
CustomFilterDisplayText Allows you to customize the text displayed within the Filter Panel.
CustomizationFormSearch Allows you to filter search results when a user searches in the Advanced Customization Form.
CustomizeNewNodeFromOuterData Allows you to initialize a new node when a user drops the node from another TreeList control onto the current TreeList control.
CustomizeNodeTemplate Allows you to customize templated nodes.
CustomNodeCellEdit Enables editors to be assigned to cells on an individual basis. To avoid performance issues and increased memory consumption, assign repository items that already exist in the TreeList.RepositoryItems collection. Do not create new repository items in this handler.
CustomNodeCellEditForEditing Allows you to assign a custom editor to a column for in-place editing and override the default column editor, which is by default used both in display and edit modes. To avoid performance issues and increased memory consumption, assign repository items that already exist in the TreeList.RepositoryItems collection. Do not create new repository items in this handler.
CustomRowFilter Allows you to specify the node visibility, regardless of the applied filter.
CustomScrollAnnotation Allows you to specify custom annotations.
CustomUnboundColumnData Allows you to provide data to unbound columns, and save their modified records to an external source.
DataSourceChanged Occurs whenever the TreeList changes its data source.
DefaultPaintHelperChanged Fires when a different paint helper is assigned to the TreeList control.
Disposed Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DockChanged Occurs when the value of the Dock property changes. Inherited from Control.
DoubleClick Occurs when the control is double-clicked. Inherited from Control.
DragCancelNode Fires immediately after a drag-and-drop operation over a node has been canceled.
DragDrop Occurs when a drag-and-drop operation is completed. Inherited from Control.
DragEnter Occurs when an object is dragged into the control’s bounds. Inherited from Control.
DragLeave Occurs when an object is dragged out of the control’s bounds. Inherited from Control.
DragObjectDrop Fires immediately after the drag and drop operation has been completed.
DragObjectOver Enables you to control whether the dragged column header can be dropped at the current position.
DragObjectStart Fires when an end-user attempts to drag a column header.
DragOver Occurs when an object is dragged over the control’s bounds. Inherited from Control.
EditFormHidden Fires after the Edit Form is closed.
EditFormPrepared Fires when the Edit Form is about to be displayed. Allows you to customize the Edit Form.
EditFormShowing Fires when the Edit Form is about to be displayed. Allows you to cancel the action.
EditorKeyDown Occurs when a key is pressed within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EditorKeyPress Occurs when a character key is pressed within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EditorKeyUp Occurs when a pressed key is released within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EnabledChanged Occurs when the Enabled property value has changed. Inherited from Control.
EndSorting Fires after a sorting operation has finished.
Enter Occurs when the control is entered. Inherited from Control.
FilterEditorCreated Allows you to customize the Filter Editor before it is displayed on screen.
FilterExpressionEditorCreated Allows you to customize the Expression Editor used to edit custom expressions that are displayed in the control’s Filter Editor.
FilterNode This event is obsolete. Use the TreeList.CustomRowFilter event instead.
FilterPopupExcelCustomizeTemplate Allows you to customize templates used by Excel-style Filter Dropdowns and external editors generated using Filtering UI Context.
FilterPopupExcelData Allows you to add, remove, and modify data values and customize predefined filters in the Excel style pop-up filter menus. Filter items added manually on this event must be unique and sorted.
FilterPopupExcelParseFilterCriteria Allows you to parse the filter criteria applied to data and select the corresponding values in the filter menu.
FilterPopupExcelPrepareTemplate Allows you to replace templates used by Excel-style Filter Dropdowns and external editors generated using Filtering UI Context.
FilterPopupExcelQueryFilterCriteria Fires when a filter criteria is about to be applied to data and allows you to customize the filter criteria.
FocusedColumnChanged Fires immediately after focus has been moved from a column.
FocusedNodeChanged Fires when focus moves from one node to another.
FontChanged Occurs when the Font property value changes. Inherited from Control.
ForeColorChanged Occurs when the ForeColor property value changes. Inherited from Control.
FormatRuleExpressionEditorCreated Allows you to customize the Expression Editor embedded in the Edit Formatting Rule dialog.
GetCustomNodeCellEdit Obsolete. Provides the ability to assign editors to individual cells.
GetCustomNodeCellStyle Obsolete. Provides the ability to assign custom style to individual cells.
GetCustomSummaryValue Allows you to specify custom summary values when the control is displayed on-screen.
GetNodeDisplayValue Allows you to display custom values within cells. This event is obsolete. Use the TreeList.CustomColumnDisplayText event instead.
GetPreviewText Enables you to supply custom text for nodes’ preview sections.
GetPrintCustomSummaryValue Allows you to specify custom summary values when the control is printed.
GetPrintPreviewText Enables you to display custom text in preview sections when the control is printed.
GetSelectImage Allows you to assign select images to nodes.
GetStateImage Allows you to assign state images to nodes.
GiveFeedback Occurs during a drag operation. Inherited from Control.
GotFocus Occurs when the control receives focus. Inherited from Control.
HandleCreated Occurs when a handle is created for the control. Inherited from Control.
HandleDestroyed Occurs when the control’s handle is in the process of being destroyed. Inherited from Control.
HelpRequested Occurs when the user requests help for a control. Inherited from Control.
HiddenEditor Fires immediately after a cell editor has been closed.
HideCustomizationForm Fires immediately after the Customization Form has been closed.
HtmlElementMouseClick Occurs when a user clicks an element inside an HTML-CSS template.
HtmlElementMouseDoubleClick Occurs when a user double-clicks any element of an HTML-CSS template.
HtmlElementMouseDown Occurs when a mouse pointer is over an element of an HTML-CSS template, and a mouse button is pressed.
HtmlElementMouseMove Occurs when a mouse pointer moves while over an element of an HTML-CSS template.
HtmlElementMouseOut Occurs when a mouse pointer leaves the bounds of an element within an HTML-CSS template.
HtmlElementMouseOver Occurs when a mouse pointer enters the bounds of an element within an HTML-CSS template.
HtmlElementMouseUp Occurs when a mouse button pressed over an element of an HTML-CSS template is released.
HtmlSelectedTextChanged
HyperlinkClick Fires when a hyperlink in a column or band header is activated.
ImeModeChanged Occurs when the ImeMode property has changed. Inherited from Control.
InitNewRow Fires when a new node is about to be created in the New Item Row and allows you to initialize column values.
Invalidated Occurs when a control’s display requires redrawing. Inherited from Control.
InvalidNodeException Fires when a node fails validation or when its data cannot be saved to the data source.
InvalidValueException Enables you to handle exceptions raised as a result of assigning invalid values to cells.
KeyDown Occurs when a key is pressed while the control has focus. Inherited from Control.
KeyPress Occurs when a character. space or backspace key is pressed while the control has focus. Inherited from Control.
KeyUp Occurs when a key is released while the control has focus. Inherited from Control.
Layout Occurs when a control should reposition its child controls. Inherited from Control.
LayoutUpdated Fires after a Tree List’s layout has been changed.
LayoutUpgrade Occurs after a layout the version of which doesn’t match the current layout version used has been loaded from storage (a stream, xml file or system registry).
Leave Occurs when the input focus leaves the control. Inherited from Control.
LeftCoordChanged Fires when the control’s content is scrolled horizontally.
Load Occurs when a TreeList control is displayed for the first time.
LocationChanged Occurs when the Location property value has changed. Inherited from Control.
LostFocus Occurs when the control loses focus. Inherited from Control.
MarginChanged Occurs when the control’s margin changes. Inherited from Control.
MeasurePreviewHeight Allows you to specify the height of individual preview sections in pixels.
MouseCaptureChanged Occurs when the control loses mouse capture. Inherited from Control.
MouseClick Occurs when the control is clicked by the mouse. Inherited from Control.
MouseDoubleClick Occurs when the control is double clicked by the mouse. Inherited from Control.
MouseDown Occurs when the mouse pointer is over the control and a mouse button is pressed. Inherited from Control.
MouseEnter Occurs when the mouse pointer enters the control. Inherited from Control.
MouseHover Occurs when the mouse pointer rests on the control. Inherited from Control.
MouseLeave Occurs when the mouse pointer leaves the control. Inherited from Control.
MouseMove Occurs when the mouse pointer is moved over the control. Inherited from Control.
MouseUp Occurs when the mouse pointer is over the control and a mouse button is released. Inherited from Control.
MouseWheel Occurs when the mouse wheel moves while the control has focus. Inherited from Control.
Move Occurs when the control is moved. Inherited from Control.
NodeCellStyle Allows you to customize the appearance of individual cells.
NodeChanged Fires after the node’s property has changed.
NodesReloaded Fires when the Tree List control reloads all nodes.
PaddingChanged Occurs when the control’s padding changes. Inherited from Control.
Paint Occurs when the control is redrawn. Inherited from Control.
PaintEx A DirectX-compatible event that replaces the standard Control.Paint event.
ParentChanged Occurs when the Parent property value changes. Inherited from Control.
ParseFindPanelText Fires after the query in the find panel changes. Allows you to create a filter condition based on the query and specify how to highlight results in the control.
PopupMenuShowing Allows you to customize default context menus or invoke custom menus.
PreviewKeyDown Occurs before the KeyDown event when a key is pressed while focus is on this control. Inherited from Control.
PrintExportProgress Fires repeatedly while the TreeList’s data is being printed/exported.
PropertyDeserializing Allows you to restore certain settings previously saved in the layout.
PropertySerializing Allows you to include certain settings in the layout when you save it.
QueryAccessibilityHelp Occurs when AccessibleObject is providing help to accessibility applications. Inherited from Control.
QueryContinueDrag Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. Inherited from Control.
QueryCustomFunctions Allows you to add custom-function-based filters (for example, ‘discount is more than 15%’) to Excel-style pop-up filter menus and/or the filter editor.
QueryEmptyTreeTemplate Allows you to assign HTML-CSS templates from the HtmlTemplates collection to an empty TreeList.
QueryNodeTemplate Allows you to assign HTML-CSS templates from the HtmlTemplates collection to nodes.
RegionChanged Occurs when the value of the Region property changes. Inherited from Control.
Resize Occurs when the control is resized. Inherited from Control.
RightToLeftChanged Occurs when the RightToLeft property value changes. Inherited from Control.
RowCellClick Fires when a cell is clicked.
RowClick Fires when a row (node) is clicked.
RowSelectImageClick Fires when a row’s select image is clicked.
RowStateImageClick Fires when a row’s state image is clicked.
ScrollAnnotationsStyle Allows you to customize the scrollbar annotation color and alignment.
SelectImageClick Fires when the user clicks a node’s select image. This event is obsolete. Use RowSelectImageClick instead.
SelectionChanged Fires when node selection is changed. In v21.1 and higher, the event fires both in single and multiple node selection modes.
SelectionChanging Allows you to specify whether users can select and unselect nodes.
ShowCustomizationForm Fires immediately after the Customization Form has been displayed.
ShowFilterPopupCheckedListBox Fires before a pop-up filter menu is displayed. Allows you to customize the value checklist.
ShowFilterPopupDate Allows you to customize a column’s dropdown calendar before it is displayed.
ShowFilterPopupExcel Allows you to hide specific filter conditions from the Filters tab of the Excel-style Drop-down Filter.
ShowFilterPopupListBox Fires before a pop-up filter menu is displayed. Allows you to customize the value list.
ShowingEditor Fires before the TreeList is switched to edit mode.
ShownEditor Fires immediately after a cell editor has been invoked.
ShowTreeListMenu Obsolete. Allows you to customize the default menus for column headers, row and footer summaries, nodes, and the empty area.
SizeChanged Occurs when the Size property value changes. Inherited from Control.
StartSorting Fires before a sorting operation is started.
StateChanged Fires after the Tree List’s state has changed.
StateImageClick Fires when the user clicks a node’s state image. This event is obsolete. Use RowStateImageClick instead.
StyleChanged Occurs when the control style changes. Inherited from Control.
SubstituteFilter Allows you to replace the applied filter with another filter.
SystemColorsChanged Occurs when the system colors change. Inherited from Control.
TabIndexChanged Occurs when the TabIndex property value changes. Inherited from Control.
TabStopChanged Occurs when the TabStop property value changes. Inherited from Control.
TextChanged Occurs when the Text property value changes. Inherited from Control.
TopVisibleNodeIndexChanged Fires when the control’s content is scrolled vertically.
TreeListMenuItemClick Provides the ability to perform custom handling of a context menu item click.
UnboundExpressionEditorCreated Fires after an Expression Editor has been created for an unbound column.
Validated Occurs when the control is finished validating. Inherited from Control.
ValidateNode Gives you the ability to specify whether a modified node’s data is valid, and if this node can lose focus.
Validating Occurs when the control is validating. Inherited from Control.
ValidatingEditor Fires when an editor is validated.
VirtualTreeGetCellValue This event allows you to initialize cells (and optionally the check state) of the processed node, when populating the Tree List control with data dynamically.
VirtualTreeGetChildNodes Allows you to supply root and child nodes, when populating the Tree List control with data dynamically.
VirtualTreeSetCellValue Allows changes that are made to node cells and check state to be stored.
VisibleChanged Occurs when the Visible property value changes. Inherited from Control.
See Also