Skip to content

Commit 53b75b2

Browse files
committed
address comemnts
1 parent 4c87549 commit 53b75b2

File tree

9 files changed

+31
-33
lines changed

9 files changed

+31
-33
lines changed

controls/datapager/integration/treedatagrid.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ slug: datapager-treedatagrid
88

99
# .NET MAUI DataPager Integration with TreeDataGrid
1010

11-
You can page the data of the [Telerik UI for .NET MAUI DataGrid]({%slug datagrid-overview%}) by using the DataPager control.
11+
You can page the data of the [Telerik UI for .NET MAUI TreeDataGrid]({%slug treedatagrid-overview%}) by using the DataPager control.
1212

1313
![.NET MAUI DataPager with TreeDataGrid](../images/datapager-treedatagrid-paging.png)
1414

controls/treedatagrid/descriptor.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,16 @@ slug: treedatagrid-descriptor
88

99
# .NET MAUI TreeDataGrid Item Hierarchy
1010

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+
1213
To specify the data items' hierarchy and how each item is visualized, use the `TreeDataGridItemDescriptor` class.
1314

1415
The `TreeDataGridItemDescriptor` class exposes the following properties:
1516

1617
| Property | Description |
1718
| -------- | ----------- |
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. |
2221

2322
Here is an example demonstrating how to define the data items' hierarchy by using the TreeDataGrid descriptor:
2423

@@ -63,6 +62,10 @@ public static class MauiProgram
6362
}
6463
```
6564

65+
This is the result on winUi and on Android:
66+
67+
![.NET MAUI TreeDataGrid Descriptor](images/treedatagrid-getting-started.png)
68+
6669
> For a runnable example with the TreeDataGrid Descriptor scenario, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **TreeDataGrid > Getting Started** category.
6770
6871
## See Also

controls/treedatagrid/empty-template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ It exposes the following properties:
1414

1515
* `EmptyContentTemplate`(`DataTemplate`)&mdash;Defines the content of the view which is shown when in the view has no items.
1616

17-
* `EmptyContentDisplayMode`&mdash;Defines the modes for displaying empty content. The property have two modes:
17+
* `EmptyContentDisplayMode`&mdash;Defines the modes for displaying empty content. The property has two modes:
1818
- `ItemsSourceNull`&mdash;Displays the empty content view only when the `ItemsSource` is null.
19-
- `ItemsSourceNullOrEmpty`&mdash;Displays the empty content view when `ItemsSource` is null or when the source is empty(has zero items).
19+
- `ItemsSourceNullOrEmpty`&mdash;Displays the empty content view when `ItemsSource` is null or when the source is empty (has zero items).
2020

2121
> 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.
2222

controls/treedatagrid/getting-started.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -78,11 +78,10 @@ public static class MauiProgram
7878
7979
## Additional Resources
8080

81-
- [Setting the .NET MAUI TreeDataGrid Columns]({%slug datagrid-columns-overview%})
82-
- [Using the TreeDataGrid Commands]({%slug datagrid-aggregates%})
83-
- [Sorting .NET MAUI TreeDataGrid Records]({%slug datagrid-sorting%})
84-
- [Filtering .NET MAUI TreeDataGrid Records]({%slug datagrid-filtering-overview%})
85-
- [Styling the Appearance of the DataGrid]({%slug datagrid-styling%})
81+
- [Setting the .NET MAUI TreeDataGrid Columns]({%slug treedatagrid-columns-overview%})
82+
- [Using the TreeDataGrid Commands]({%slug treedatagrid-aggregates%})
83+
- [Sorting .NET MAUI TreeDataGrid Records]({%slug treedatagrid-sorting%})
84+
- [Filtering .NET MAUI TreeDataGrid Records]({%slug treedatagrid-filtering-overview%})
8685

8786
## See Also
8887

controls/treedatagrid/load-on-demand.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ position: 13
66
slug: treedatagrid-loadondemand
77
---
88

9-
# .NET MAUI DataGrid Load On Demand
9+
# .NET MAUI TreeDataGrid Load On Demand
1010

1111
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.
1212

@@ -60,9 +60,7 @@ The custom style is of type `Style` with target type `DataGridLoadOnDemandRowApp
6060

6161
The `LoadOnDemandRowTemplate` property can be used to set the template of the row that contains the **Load More** button when the `LoadOnDemandMode` is `Manual`.
6262

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.
6664
6765
## Additional Resources
6866

controls/treedatagrid/overview.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,17 @@ slug: treedatagrid-overview
99

1010
# .NET MAUI TreeDataGrid Overview
1111

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.
1313

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.
1515

1616
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.
1717

18-
![Telerik .NET MAUI Tree Data Grid on all platforms](images/treedatagrid-overview.png "Telerik .NET MAUI Tree Data Grid")
18+
![Telerik .NET MAUI Tree Data Grid on all platforms](images/treedatagrid-overview.png)
1919

2020
## Data Binding
2121

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.
2323

2424
## Built-in Columns
2525

@@ -29,7 +29,7 @@ The MAUI TreeDataGrid provides a set of [built-in columns]({%slug treedatagrid-c
2929

3030
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.
3131

32-
## Sort, Filter Data
32+
## Sort and Filter Data
3333

3434
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.
3535

controls/treedatagrid/render-mode.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ slug: treedatagrid-render-mode
88

99
# .NET MAUI TreeDataGrid Render Mode
1010

11-
The .NET MAUI TreeDataGrid is rendered differently depending on the target platform&mdash;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&mdash;on Android and Windows, it uses the SkiaSharp library, and on iOS and MacCatalyst, it uses native elements by default.
1212

1313
With the `RenderMode` property you can enable SkiaSharp rendering on iOS and MacCatalyst:
1414

15-
* `RenderMode`(`DataGridRenderMode`)&mdash;Defines how the content of the TreeDataGrid is rendered: using the defaults or via SkiaSharp. The available options are:
16-
* `Default`&mdash;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 <a href="https://developer.apple.com/documentation/uikit/uilabel" target="_blank"><code>UILabel</code></a> and <a href="https://developer.apple.com/documentation/uikit/uiview" target="_blank"><code>UIView</code></a> primitives.
17-
* `SkiaSharp`&mdash;SkiaSharp is used for rendering on all platforms.
18-
15+
* `RenderMode`(`DataGridRenderMode`)&mdash;Defines how the content of the TreeDataGrid is rendered: using the default platform-specific rendering or SkiaSharp. The available options are:
16+
* `Default`&mdash;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 <a href="https://developer.apple.com/documentation/uikit/uilabel" target="_blank"><code>UILabel</code></a> and <a href="https://developer.apple.com/documentation/uikit/uiview" target="_blank"><code>UIView</code></a> primitives.
17+
* `SkiaSharp`&mdash;SkiaSharp is used to render the TreeDataGrid on all platforms.
18+
1919
>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.
2020
2121
## See Also

controls/treedatagrid/scrolling.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The [Telerik UI for .NET MAUI TreeDataGrid]({%slug treedatagrid-overview%}) has
1313

1414
>important Avoid nesting the TreeDataGrid in a `ScrollView` and other controls that provide scrolling.
1515
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.
1717

1818
For more details, review the article on [setting the .NET MAUI TreeDataGrid rows]({%slug treedatagrid-row-height%}).
1919

controls/treedatagrid/search-as-you-type.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ slug: treedatagrid-search-as-you-type
99

1010
# .NET MAUI TreeDataGrid Search as You Type
1111

12-
[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`.
1313

1414
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.
1515

@@ -31,7 +31,7 @@ The default searching behavior works in the following way: as soon as the user t
3131

3232
Below you can find a list of the available configuration options applied through the `RadDataGrid.SearchSettings`:
3333

34-
* `IntermediateSearchText`(`string`)&mdash;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`)&mdash;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.
3535
* `SearchText`(`string`)&mdash;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.
3636
* `SearchTrigger`(`DataGridSearchTrigger`)&mdash;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:
3737
* `TextChanged`&mdash;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
6868
* `CloseSearchPanelCommand`&mdash;Called when pressing the Close button in the search panel.
6969
* `SearchEntryCompletedCommand`&mdash;Called when the `Completed` event of the search entry in the search panel is raised.
7070

71-
## Examples
7271

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.
7473
7574
## See Also
7675

7776
- [Localization in .NET MAUI TreeDataGrid]({%slug treedatagrid-localization%})
7877
- [Defining Columns]({%slug treedatagrid-columns-overview%})
79-
- [Columns Styling]({%slug treedatagrid-columns-styling%})

0 commit comments

Comments
 (0)