You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: controls/treedatagrid/descriptor.md
+8-5Lines changed: 8 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,17 +8,16 @@ slug: treedatagrid-descriptor
8
8
9
9
# .NET MAUI TreeDataGrid Item Hierarchy
10
10
11
-
The TreeDataGrid for MAUI exposes `ItemDescriptors` collection (`IList<TreeDataGridItemDescriptor>`). The collection defines the entities that describe an item.
11
+
The TreeDataGrid for MAUI exposes an `ItemDescriptor` proeprty (of type `TreeDataGridItemDescriptor`), which defines the entities that describe an item.
12
+
12
13
To specify the data items' hierarchy and how each item is visualized, use the `TreeDataGridItemDescriptor` class.
13
14
14
15
The `TreeDataGridItemDescriptor` class exposes the following properties:
15
16
16
17
| Property | Description |
17
18
| -------- | ----------- |
18
-
|`ChildrenBinding` (`BindingBase`) | Specifies the binding that provides the children of an item in the TreeDataGrid. |
19
-
|`ShouldDisplayTreeArrowBinding` (`BindingBase`) | Specifies the binding that checks whether a tree arrow should be displayed for an item that has children. |
20
-
21
-
> You can define multiple descriptors in the TreeDataGrid.
19
+
|`ItemsSourceBinding` (`BindingBase`) | Specifies the binding that provides the children of an item in the TreeDataGrid. |
20
+
|`IsExpandableBinding` (`BindingBase`) | Specifies the binding that determines whether a tree arrow is displayed for items with children. |
22
21
23
22
Here is an example demonstrating how to define the data items' hierarchy by using the TreeDataGrid descriptor:
24
23
@@ -63,6 +62,10 @@ public static class MauiProgram
> For a runnable example with the TreeDataGrid Descriptor scenario, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **TreeDataGrid > Getting Started** category.
Copy file name to clipboardExpand all lines: controls/treedatagrid/empty-template.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ It exposes the following properties:
14
14
15
15
*`EmptyContentTemplate`(`DataTemplate`)—Defines the content of the view which is shown when in the view has no items.
16
16
17
-
*`EmptyContentDisplayMode`—Defines the modes for displaying empty content. The property have two modes:
17
+
*`EmptyContentDisplayMode`—Defines the modes for displaying empty content. The property has two modes:
18
18
- `ItemsSourceNull`—Displays the empty content view only when the `ItemsSource` is null.
19
-
- `ItemsSourceNullOrEmpty`—Displays the empty content view when `ItemsSource` is null or when the source is empty(has zero items).
19
+
- `ItemsSourceNullOrEmpty`—Displays the empty content view when `ItemsSource` is null or when the source is empty(has zero items).
20
20
21
21
> As the TreeDataGrid inhertis from the DataGrid, for a runnable example with empty template scenario, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Empty Template** category.
Copy file name to clipboardExpand all lines: controls/treedatagrid/load-on-demand.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ position: 13
6
6
slug: treedatagrid-loadondemand
7
7
---
8
8
9
-
# .NET MAUI DataGrid Load On Demand
9
+
# .NET MAUI TreeDataGrid Load On Demand
10
10
11
11
The [Telerik UI for .NET MAUI TreeDataGrid]({%slug treedatagrid-overview%}) enables you to improve its performance and save computing resources, by loading data in the `RadTreeDataGrid` when the control is already displayed.
12
12
@@ -60,9 +60,7 @@ The custom style is of type `Style` with target type `DataGridLoadOnDemandRowApp
60
60
61
61
The `LoadOnDemandRowTemplate` property can be used to set the template of the row that contains the **Load More** button when the `LoadOnDemandMode` is `Manual`.
62
62
63
-
## Examples
64
-
65
-
For runnable examples with the TreeDataGrid Load On Demand options, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Load On Demand** category. Replace the examples with `TreeDataGrid` and set a `ViewModel` and Data models with hierarchical data structrue.
63
+
> For runnable examples with the TreeDataGrid Load On Demand options, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Load On Demand** category. Replace the examples with `TreeDataGrid` and set a `ViewModel` and Data models with a hierarchical data structure.
Copy file name to clipboardExpand all lines: controls/treedatagrid/overview.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,17 +9,17 @@ slug: treedatagrid-overview
9
9
10
10
# .NET MAUI TreeDataGrid Overview
11
11
12
-
The Telerik UI for [.NET MAUI TreeDataGrid](https://www.telerik.com/maui-ui/treedatagrid) control presents hierarchical data with rows and columns. The TreeDataGrid inherits from the [DataGrid]({%slug datagrid-overview%}) control and combines the powerful data-driven features from the [DataGrid]({%slug datagrid-overview%}) control and showing the data in a tree like structure.
12
+
The Telerik UI for [.NET MAUI TreeDataGrid](https://www.telerik.com/maui-ui/treedatagrid) control presents hierarchical data with rows and columns. The TreeDataGrid inherits from the [DataGrid]({%slug datagrid-overview%}) control and combines its powerful data-driven features with a tree-like structure for displaying data.
13
13
14
-
When the data from a database is sent to the client, usually converted to a business object (or the so-called `ViewModel`) where each instance represents a table row and each property of the object represents a column within the original table. The TreeDataGrid also supports alternating row colors so that your users can distinguish one row from another.
14
+
When data from a database is sent to the client, it is usually converted to a business object (or the so-called `ViewModel`) where each instance represents a table row and each property of the object represents a column within the original table. The TreeDataGrid also supports alternating row colors so that your users can distinguish one row from another.
15
15
16
16
The optimized data layer of the TreeDataGrid enables fast grouping, sorting, and filtering operations. The user interface uses virtualization for its row and cell elements, which means that visual elements are created only when needed and only for the currently visible cells.
17
17
18
-

18
+

19
19
20
20
## Data Binding
21
21
22
-
The TreeDataGrid control allows you to set the collection of custom business object as an `ItemsSource` in combination with a `TreeDataGridItemDescriptor` class to visualize the hierarchically-structured source.
22
+
The TreeDataGrid control allows you to set the collection of custom business object as an `ItemsSource` in combination with a `TreeDataGridItemDescriptor` class to visualize the hierarchical structure.
23
23
24
24
## Built-in Columns
25
25
@@ -29,7 +29,7 @@ The MAUI TreeDataGrid provides a set of [built-in columns]({%slug treedatagrid-c
29
29
30
30
The .NET MAUI TreeDataGrid provides a number of features and configuration options related to its columns to provide a flexible and usable user experience. For example, you can enable [column reordering]({% slug treedatagrid-columns-reordering %}) and [resizing]({% slug treedatagrid-column-resizing %}). If you want to prevent a column from resizing, you can [lock the column]({% slug treedatagrid-frozen-columns %}) and keep the important information always on top.
31
31
32
-
## Sort, Filter Data
32
+
## Sort and Filter Data
33
33
34
34
Perform SORT and FILTER operations on your data by using the convenient API of the control. Apply the [sorting]({%slug treedatagrid-sorting%}) and [filtering]({%slug datagrid-filtering-overview%}) operations per column.
Copy file name to clipboardExpand all lines: controls/treedatagrid/render-mode.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,14 +8,14 @@ slug: treedatagrid-render-mode
8
8
9
9
# .NET MAUI TreeDataGrid Render Mode
10
10
11
-
The .NET MAUI TreeDataGrid is rendered differently depending on the target platform—on Android and Windows it uses the SkiaSharp library and on iOS and MacCatalyst by default it uses native elements.
11
+
The .NET MAUI TreeDataGrid is rendered differently depending on the target platform—on Android and Windows, it uses the SkiaSharp library, and on iOS and MacCatalyst, it uses native elements by default.
12
12
13
13
With the `RenderMode` property you can enable SkiaSharp rendering on iOS and MacCatalyst:
14
14
15
-
*`RenderMode`(`DataGridRenderMode`)—Defines how the content of the TreeDataGrid is rendered: using the defaults or via SkiaSharp. The available options are:
16
-
*`Default`—Sets the rendering mode of the DataGrid content to the default. The default rendering mode is determined by the platform. On Android and WinUI, the DataGrid is rendered with SkiaSharp. On iOS and MacCatalyst, the TreeDataGrid is rendered with the iOS <ahref="https://developer.apple.com/documentation/uikit/uilabel"target="_blank"><code>UILabel</code></a> and <ahref="https://developer.apple.com/documentation/uikit/uiview"target="_blank"><code>UIView</code></a> primitives.
17
-
*`SkiaSharp`—SkiaSharp is used for rendering on all platforms.
18
-
15
+
*`RenderMode`(`DataGridRenderMode`)—Defines how the content of the TreeDataGrid is rendered: using the default platform-specific rendering or SkiaSharp. The available options are:
16
+
*`Default`—Sets the rendering mode of the TreeDataGrid content to the default. The default rendering mode is determined by the platform. On Android and WinUI, the DataGrid is rendered with SkiaSharp. On iOS and MacCatalyst, the TreeDataGrid is rendered with the iOS <ahref="https://developer.apple.com/documentation/uikit/uilabel"target="_blank"><code>UILabel</code></a> and <ahref="https://developer.apple.com/documentation/uikit/uiview"target="_blank"><code>UIView</code></a> primitives.
17
+
*`SkiaSharp`—SkiaSharp is used to render the TreeDataGrid on all platforms.
18
+
19
19
>When using the `SkiaSharp` rendering mode, you can customize the rendering of each column through the `CellRenderer` property of the `DataGridTextColumn`. See [SkiaSharp Cell Renderer]({%slug treedatagrid-skiasharp-cell-renderer%}) for more details.
Copy file name to clipboardExpand all lines: controls/treedatagrid/scrolling.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ The [Telerik UI for .NET MAUI TreeDataGrid]({%slug treedatagrid-overview%}) has
13
13
14
14
>important Avoid nesting the TreeDataGrid in a `ScrollView` and other controls that provide scrolling.
15
15
16
-
For implementing programmatic scrolling to a specific item, use the `ScrollItemIntoView(object item)` method, which brings the specified data item into view. Note that `ScrollItemIntoView` works in scenarios where the TreeDataGrid Rows are with the same height.
16
+
For the implementation of programmatic scrolling to a specific item, use the `ScrollItemIntoView(object item)` method, which brings the specified data item into view. Note that `ScrollItemIntoView` works in scenarios where the TreeDataGrid Rows are with the same height.
17
17
18
18
For more details, review the article on [setting the .NET MAUI TreeDataGrid rows]({%slug treedatagrid-row-height%}).
[Telerik UI for .NET MAUI TreeDataGrid]({%slug datagrid-overview%}) provides the ability to search for specific data within its `ItemsSource` by using its built-in search functionality. The default behavior is to Search as You Type, but it can also be performed when the end user finishes typing and presses `Enter`.
12
+
[Telerik UI for .NET MAUI TreeDataGrid]({%slug treedatagrid-overview%}) provides the ability to search for specific data within its `ItemsSource` by using its built-in search functionality. The default behavior is to Search as You Type, but it can also be performed when the end user finishes typing and presses `Enter`.
13
13
14
14
Through the DataGrid's `SearchSettings` property, you can control when to show the search panel as well as configure the way the search is performed so that it best suits the end users' needs.
15
15
@@ -31,7 +31,7 @@ The default searching behavior works in the following way: as soon as the user t
31
31
32
32
Below you can find a list of the available configuration options applied through the `RadDataGrid.SearchSettings`:
33
33
34
-
*`IntermediateSearchText`(`string`)—Specifies the text of the search entry. A change of this value will not necessarily trigger a search, for example,it will not necessarily change the `SearchText` property. The `SearchText` property is updated in accordance with the `SearchTrigger` property.
34
+
*`IntermediateSearchText`(`string`)—Specifies the text of the search entry. A change of this value will not necessarily trigger a search, for example,it will not necessarily change the `SearchText` property. The `SearchText` property is updated in accordance with the `SearchTrigger` property.
35
35
*`SearchText`(`string`)—Specifies the search text. Before a search is started, the `SearchStarting` event is raised. The `SearchStarting` event allows for a change in the effective search text that will be used for searching.
36
36
*`SearchTrigger`(`DataGridSearchTrigger`)—Indicates when a search operation will be performed while the end user is typing in the search entry of the search panel. The available options are:
37
37
*`TextChanged`—The search operation is triggered every time the text of the entry changes.
@@ -68,12 +68,10 @@ The `DataGrid.SearchSettings` allows you to attach commands that will be execute
68
68
*`CloseSearchPanelCommand`—Called when pressing the Close button in the search panel.
69
69
*`SearchEntryCompletedCommand`—Called when the `Completed` event of the search entry in the search panel is raised.
70
70
71
-
## Examples
72
71
73
-
For runnable examples with the TreeDataGrid Search options, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Search** category. Replace the examples with `RadTreeDataGrid` definition and set a `ViewModel` and Data models with hierarchical data structrue.
72
+
> For runnable examples with the TreeDataGrid Search options, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Search** category. Replace the examples with `RadTreeDataGrid` definition and set a `ViewModel` and Data models with hierarchical data structure.
74
73
75
74
## See Also
76
75
77
76
-[Localization in .NET MAUI TreeDataGrid]({%slug treedatagrid-localization%})
0 commit comments