Back to Devexpress

DxTreeList Members

blazor-devexpress-dot-blazor-dot-dxtreelist-dot-underscore-members.md

latest33.9 KB
Original Source

DxTreeList Members

A component that displays hierarchical data in a tabular format and allows users to edit, sort, filter, and otherwise shape data.

Constructors

NameDescription
DxTreeList()Initializes a new instance of the DxTreeList class.

Properties

NameDescription
AllowColumnReorderSpecifies whether users can reorder columns.
AllowDragRowsSpecifies whether users can start the row drag operation.
AllowedDropTargetSpecifies allowed drag-and-drop targets.
AllowSelectRowByClickSpecifies whether users can select and deselect rows by mouse clicks, tap gestures, and keyboard shortcuts.
AllowSortSpecifies whether users can sort treelist data.
AttributesSpecifies a collection of standard HTML attributes applied to the TreeList.
AutoExpandAllNodesSpecifies whether to automatically expand all nodes when the TreeList loads data.
ChildrenFieldNameSpecifies the field name that stores the node’s child data items.
ColumnCaptionAlignmentSpecifies the alignment of all column captions.
ColumnFooterTemplateSpecifies a common template used to display all footer cells in the TreeList.
ColumnHeaderCaptionTemplateSpecifies a common template used to display captions of all column headers in the TreeList.
ColumnResizeModeSpecifies whether and how users can resize TreeList columns.
ColumnsAllows you to add TreeList columns.
ContextMenusSpecifies available context menus.
CssClassAssigns a CSS class to the TreeList.
CustomValidatorsAllows you to declare custom validator components.
DataSpecifies a data source.
DataColumnCellDisplayTemplateSpecifies a common template used to display all data column cells in the TreeList.
DataColumnCellEditTemplateAllows you to replace automatically generated editors with custom content in all edit cells displayed for data columns.
DataColumnFilterMenuTemplateSpecifies a common template used to display all column filter menus.
DataColumnFilterRowCellTemplateAllows you to replace automatically generated editors with custom content in all filter row cells displayed for data columns.
DragHintTextTemplateSpecifies the template for the drag hint.
DropTargetModeSpecifies the drop position behavior. Applicable only to drag and drop operations initiated externally.
EditFormButtonsVisibleSpecifies whether the edit form contains predefined Save and Cancel buttons.
EditFormTemplateSpecifies the template used to display the edit form.
EditModeSpecifies how users can edit TreeList data.
EditNewRootRowPositionSpecifies the position of UI elements used to create new root nodes.
EditOnKeyPressIn EditCell mode, specifies whether cell editing starts once a user begins typing a new value.
EmptyDataAreaTemplateSpecifies the template used to display an empty data area.
EnterKeyDirectionIn EditCell mode, specifies where focus moves after a user presses Enter.
FilterBuilderTemplateSpecifies the template for the filter builder.
FilterMenuButtonDisplayModeSpecifies when the TreeList displays filter menu buttons in column headers.
FilterPanelDisplayModeSpecifies the filter panel visibility.
FilterTreeModeSpecifies how the TreeList component displays filtered nodes.
FocusedRowEnabledSpecifies whether row focus is enabled.
FooterDisplayModeSpecifies when to display the footer in the TreeList.
HasChildrenFieldNameSpecifies the field name that defines whether a node has children.
HighlightRowOnHoverSpecifies whether to highlight a data row when a user hovers the mouse pointer over it.
KeyFieldNameSpecifies the field name that contains unique identifiers for TreeList nodes.
PageIndexSpecifies the active page index.
PagerAutoHideNavButtonsSpecifies whether arrow navigation buttons are hidden when all numeric buttons are displayed in the pager.
PagerNavigationModeSpecifies how users navigate between TreeList pages.
PagerPositionSpecifies the pager position.
PagerSwitchToInputBoxButtonCountSpecifies the total number of pages when the pager switches from numeric buttons to the input box in Auto mode.
PagerVisibleSpecifies whether the TreeList displays the pager.
PagerVisibleNumericButtonCountSpecifies the maximum number of numeric buttons displayed in the pager.
PageSizeSpecifies the maximum number of rows displayed on a page.
PageSizeSelectorAllRowsItemVisibleSpecifies whether the page size selector contains the All item.
PageSizeSelectorItemsSpecifies items available in the page size selector.
PageSizeSelectorVisibleSpecifies whether the TreeList displays the page size selector in the pager.
ParentKeyFieldNameSpecifies the field that links a node to its parent.
PopupEditFormCssClassAssigns a CSS class to the pop-up edit form.
PopupEditFormHeaderTextSpecifies text displayed in the pop-up edit form’s header.
RootValueSpecifies the value that root nodes contain in the field assigned to the ParentKeyFieldName property.
SearchBoxInputDelaySpecifies the delay between the last typed character in the search box and the search update.
SearchBoxNullTextSpecifies the prompt text displayed in the search box when it is empty.
SearchBoxTemplateSpecifies a template for the search box.
SearchTextSpecifies the text that the TreeList uses to filter and highlight data.
SearchTextParseModeSpecify how the TreeList searches for a match if the query contains multiple words.
SelectAllCheckboxModeSpecifies whether the Select All checkbox selects all rows on the current page or on all TreeList pages.
SelectedDataItemIn single selection mode, this property specifies the data item that corresponds to the selected TreeList row.
SelectedDataItemsIn multiple selection mode, this property specifies data items that correspond to selected TreeList rows.
SelectionModeSpecifies the selection mode.
ShowAllRowsSpecifies whether the TreeList displays all rows on one page. To avoid performance issues when the TreeList is bound to a large data source, use the VirtualScrollingEnabled property instead.
ShowFilterRowSpecifies whether the TreeList displays the filter row.
ShowSearchBoxSpecifies whether the TreeList displays the search box.
SizeModeSpecifies the size of TreeList elements (for instance, text size and row height) and other built-in components (for instance, pager and buttons).
SkeletonRowsEnabledSpecifies whether the TreeList displays skeletons while it loads data.
TextWrapEnabledSpecifies whether the TreeList wraps words or if it trims extra words and displays an ellipsis.
ToolbarTemplateSpecifies a template for a toolbar area.
TotalSummaryContains total summary items.
ValidationEnabledSpecifies whether the TreeList validates user input.
VirtualScrollingEnabledSpecifies whether virtual scrolling is enabled.
VirtualScrollingModeWhen VirtualScrollingEnabled is set to true, specifies whether the TreeList virtualizes rows, columns, or both.

Methods

NameDescription
AutoFitColumnWidths()Adjusts column width to content.
BeginUpdate()Suspends TreeList updates caused by parameter changes and method calls until the EndUpdate() method is called.
CancelEditAsync()Cancels row editing and discards changes.
ClearFilter()Clears the filter applied to TreeList data.
ClearSelection()Clears selection.
ClearSort()Clears sorting.
CollapseAll()Collapses all rows in the TreeList component.
CollapseRow(Int32)Collapses the row with the specified visible index.
DeselectAllAsync()Deselects all rows in the TreeList.
DeselectAllOnPage()Deselects all rows on the currently visible page except for child rows of collapsed items.
DeselectDataItem(Object)Deselects a row that corresponds to the specified data item.
DeselectDataItems(IEnumerable<Object>)Deselects rows that correspond to the specified data items.
DeselectRow(Int32)Deselects a row with the specified visible index.
DeselectRows(IEnumerable<Int32>)Deselects rows with the specified visible indexes.
EndUpdate()Resumes TreeList updates (when the BeginUpdate() method pauses updates) and re-renders the TreeList.
Equals(Object, Object) staticDetermines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object)Determines whether the specified object is equal to the current object. Inherited from Object.
ExpandAll()Expands all rows in the TreeList component.
ExpandRow(Int32)Expands the row with the specified visible index.
ExportToCsvAsync(Stream, TreeListCsvExportOptions)Exports TreeList data to a stream in CSV format.
ExportToCsvAsync(String, TreeListCsvExportOptions)Exports TreeList data in CSV format and downloads the resulting file to the client machine.
ExportToPdfAsync(Stream, TreeListPdfExportOptions)Exports TreeList data in PDF format to a stream.
ExportToPdfAsync(String, TreeListPdfExportOptions)Exports TreeList data to PDF and downloads the output file to the client machine.
ExportToXlsAsync(Stream, TreeListXlExportOptions)Exports TreeList data in XLS format to a stream.
ExportToXlsAsync(String, TreeListXlExportOptions)Exports TreeList data in XLS format and downloads the resulting file to the client machine.
ExportToXlsxAsync(Stream, TreeListXlExportOptions)Exports TreeList data in XLSX format to a stream.
ExportToXlsxAsync(String, TreeListXlExportOptions)Exports TreeList data in XLSX format and downloads the resulting file to the client machine.
FilterBy(String, TreeListFilterRowOperatorType, Object)Filters TreeList data by the specified column value.
GetColumnEditSettings<T>(String)Returns editor settings of the column bound to the specified data source field.
GetColumns()Returns a collection of all treelist columns.
GetDataColumns()Returns a data column collection.
GetDataItem(Int32)Returns a data source item bound to the row with the specified visible index.
GetDataItemValue(Object, String)Returns the value of the specified field for the specified data item.
GetEditContext()Returns the edit context.
GetFieldFilterCriteria(String)Returns the filter criteria applied to the specified field of the bound data source.
GetFilterCriteria()Returns the filter criteria applied to TreeList data.
GetFocusedDataItem()Returns a data item bound to the focused data row.
GetFocusedRowIndex()Returns the visible index of the focused row.
GetHashCode()Serves as the default hash function. Inherited from Object.
GetPageCount()Returns the total number of pages in the TreeList.
GetRowValue(Int32, String)Returns the value of the data source field in the specified row.
GetSortedColumns()Gets the collection of sorted columns.
GetStartRowVisibleIndex()Gets the visible index of the first row on the current page.
GetTotalSummaryDisplayText(ITreeListSummaryItem)Gets a total summary item’s display text.
GetTotalSummaryFormattedValue(ITreeListSummaryItem)Gets a total summary item’s formatted value.
GetTotalSummaryItems()Returns the collection of total summary items.
GetTotalSummaryLabel(ITreeListSummaryItem)Returns the name of a total summary‘s function name.
GetTotalSummaryValue(ITreeListSummaryItem)Gets a total summary item’s value.
GetType()Gets the Type of the current instance. Inherited from Object.
GetVisibleColumns()Returns a collection of visible columns sorted based on their display order.
GetVisibleRowCount()Returns the total number of visible rows in the TreeList.
IsDataItemFocused(Object)Returns whether the row bound to the specified data item is focused.
IsDataItemSelected(Object)Returns whether the row that corresponds to the specified data item is selected.
IsEditing()Returns whether the TreeList is being edited.
IsEditingNewRow()Returns whether a new TreeList row is being edited.
IsEditingRow(Int32)Returns whether the specified TreeList row is being edited.
IsRowExpanded(Int32)Returns whether the row with the specified visible index is expanded.
IsRowFocused(Int32)Returns whether the row with the specified visible index is focused.
IsRowSelected(Int32)Returns whether the specified row is selected.
LoadLayout(TreeListPersistentLayout)Restores the TreeList layout.
MakeCellVisible(Int32, String)Navigates to the cell displayed at the intersection of the specified row and data column.
MakeRowVisible(Int32)Makes the row with the specified visible index visible on screen.
MemberwiseClone() protectedCreates a shallow copy of the current Object. Inherited from Object.
ReferenceEquals(Object, Object) staticDetermines whether the specified Object instances are the same instance. Inherited from Object.
RefreshSummary()Refreshes all total summary values in the TreeList.
Reload()Reloads TreeList data.
SaveChangesAsync()Triggers validation and raises the EditModelSaving event if validation succeeds. The method immediately raises this event if validation is disabled.
SaveLayout()Saves information about the TreeList layout.
SelectAllAsync(Boolean)Selects or deselects all rows in the TreeList.
SelectAllOnPage(Boolean)Selects or deselects all rows on the currently visible page except for child rows of collapsed items.
SelectDataItem(Object, Boolean)Selects or deselects a row that corresponds to the specified data item.
SelectDataItems(IEnumerable<Object>, Boolean)Selects or deselects rows that correspond to the specified data items.
SelectRow(Int32, Boolean)Selects or deselects a row with the specified visible index.
SelectRows(IEnumerable<Int32>, Boolean)Selects or deselects rows with the specified visible indexes.
SetFieldFilterCriteria(String, CriteriaOperator)Applies a filter to the specified data field.
SetFilterCriteria(CriteriaOperator)Applies a filter to TreeList data.
SetFocusedRowIndex(Int32)Moves focus to the row with the specified visible index.
ShowColumnChooser()Shows the column chooser in the center of the treelist.
ShowColumnChooser(DialogDisplayOptions)Shows the column chooser and positions it based on specified display options.
ShowColumnChooser(String)Shows the column chooser below the specified target element.
ShowFilterBuilder()Opens the filter builder dialog.
ShowRowDeleteConfirmation(Int32)Displays the delete confirmation dialog for the specified row. If a user confirms the operation, the method raises the DataItemDeleting event.
SortBy(String, TreeListColumnSortOrder, Int32)Sorts data by column values in the specified order and specifies the sorted column’s index.
SortBy(String, TreeListColumnSortOrder)Sorts data by column values in the specified order.
SortBy(String)Sorts data by the specified column values.
StartEditNewRowAsync(Int32, String)Starts editing a new child node of the row with the specified visible index.
StartEditNewRowAsync(String)Starts editing a new root node.
StartEditRowAsync(Int32, String)Starts editing the row with the specified visible index.
ToString()Returns a string that represents the current object. Inherited from Object.
WaitForDataLoadAsync()Returns a task that completes when pending asynchronous data load operations are completed.
WaitForRemoteSourceRowLoadAsync(Int32)Returns a task that is completed when the specified row of a remote data source is loaded.

Events

NameDescription
ChildrenLoadingAllows you to populate a node with child nodes. The TreeList component raises this event for each node during initialization.
ChildrenLoadingOnDemandAllows you to populate a node with child nodes. The TreeList component raises this event when the node is expanded for the first time.
CustomizeCellDisplayTextAllows you to customize text displayed within a cell.
CustomizeContextMenuAllows you to customize context menus.
CustomizeDataRowEditorAllows you to customize a cell editor in a data row.
CustomizeEditModelAllows you to customize an automatically generated edit model or create a custom edit model.
CustomizeElementAllows you to customize TreeList cells and rows according to their values.
CustomizeFilterMenuAllows you to customize column filter menu items.
CustomizeFilterRowEditorAllows you to customize a cell editor in the filter row.
CustomizeSummaryDisplayTextAllows you to customize the summary display text.
CustomSortAllows you to implement custom logic used to sort data in the TreeList.
CustomSummaryAllows you to create custom summary items.
DataItemDeletingFires after a user confirms the delete operation in the delete confirmation dialog.
EditCancelingFires before the TreeList cancels the edit operation and discards changes.
EditModelSavingFires if validation succeeds after a user saves changes or you call the SaveChangesAsync() method.
EditStartFires before the TreeList starts editing a row.
FilterCriteriaChangedFires when filter criteria that is applied to TreeList data changes.
FocusedRowChangedFires when row focus changes.
ItemsDroppedFires when a user drops rows onto the TreeList.
LayoutAutoLoadingFires when the DxTreeList component finishes initialization and starts to load its layout.
LayoutAutoSavingFires when the TreeList layout changes.
PageIndexChangedFires when the TreeList’s active page index changes.
PageSizeChangedFires when the page size changes.
RowClickFires when a user clicks or taps a TreeList row or focuses a data cell and presses Enter.
RowDoubleClickFires when a user double clicks a TreeList row.
SearchTextChangedFires when the search text changes.
SelectedDataItemChangedIn single selection mode, fires when a TreeList row is selected.
SelectedDataItemsChangedIn multiple selection mode, fires when the selection in the TreeList changes.
ShowAllRowsChangedFires when the ShowAllRows property value changes.

See Also

DxTreeList Class

DevExpress.Blazor Namespace