Skip to content

Commit 4b5819b

Browse files
committed
add events and localization
1 parent 9225257 commit 4b5819b

File tree

2 files changed

+149
-0
lines changed

2 files changed

+149
-0
lines changed

controls/treedatagrid/events.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: Events
3+
page_title: .NET MAUI TreeDataGrid Documentation - Events
4+
description: Learn about the Telerik UI for .NET MAUI TreeDataGrid events and how to achieve various scenarios upon user interaction such as loading content on demand, binding to data, and more.
5+
position: 14
6+
tags: events
7+
slug: treedatagrid-events
8+
---
9+
10+
# .NET MAUI TreeDataGrid Events
11+
12+
The [Telerik UI for .NET MAUI TreeDataGrid]({%slug datagrid-overview%}) component inherits the events from the [DataGrid]({%slug datagrid-overview%}) control a set of events which help users achieve seamless and effective experience when interacting with the component.
13+
14+
## Loading Content on Demand
15+
16+
The load-on-demand feature gets implemented through the `LoadOnDemand` event. The `LoadOnDemand` event handler receives the following parameters:
17+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
18+
* A `LoadOnDemandEventArgs` object, which provides the `IsDataLoaded` (`bool`) property, indicating whether the data is loaded.
19+
20+
For more information, see the topic about [loading data on demand in the .NET MAUI TreeDataGrid]({%slug datagrid-features-loadondemand%}).
21+
22+
## Loading Distinct Values
23+
24+
The TreeDataGrid enables you to load the distinct values that will be displayed in the `Telerik.Maui.Controls.DataGrid.DataGridDistinctValuesFilterView` through the `DistinctValuesLoading` event. The `DistinctValuesLoading` event handler receives the following parameters:
25+
26+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
27+
* A `DistinctValuesLoadingEventArgs` object, which provides the following properties:
28+
- `DistinctValues`—Specifies a list of values of type `IEnumerable` which are to be displayed in the `DataGridDistinctValuesFilterView`.
29+
- (Read-only) `Column` of type `DataGridColumn`—Gets the column for which the distinct values are being loaded.
30+
31+
For more information, see the topic about the [available filtering options in the .NET MAUI TreeDataGrid]({%slug treedatagrid-filtering-overview%}).
32+
33+
## Binding to Data
34+
35+
The TreeDataGrid also gives you the option to use the `DataBindingComplete` event which occurs when the associated TreeDataGrid `ItemsSource` has been successfully bound to the control, or when any data operation like grouping, sorting, or filtering is applied. The `DataBindingComplete` event handler receives the following parameters:
36+
37+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
38+
* A `DataBindingCompleteEventArgs` object, which provides the `DataView` (`IDataViewCollection`) property and allows for traversing and/or manipulating the already computed data view.
39+
40+
## Modifying the Selection
41+
42+
The TreeDataGrid inherits the `SelectionChanged` event which is triggered whenever the `SelectedItems` collection is changed. The `SelectionChanged` event handler receives the following parameters:
43+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
44+
* A `DataGridSelectionChangedEventArgs` object, which provides the following properties:
45+
- `RemovedItems`—Gets a list of the removed items from the `SelectedItems` collection.
46+
- `AddedItems`—Gets a list of the added items to the `SelectedItems` collection.
47+
48+
For more information, see the article about the [`SelectionChanged` event of the .NET MAUI TreeDataGrid]({%slug treedatagrid-selection-overview%}).
49+
50+
## Changing the Current Cell
51+
52+
The TreeDataGrid also supports the `CurrentCellChanged` event which is invoked when the current cell changes. The `CurrentCellChanged` event handler receives the following parameters:
53+
54+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
55+
* A `CurrentCellChangedEventArgs` object, which provides the following properties:
56+
- `OldCurrentCell`—Gets the previously `CurrentCell`.
57+
- `NewCurrentCell`—Gets the new `CurrentCell`.
58+
59+
For more information, see the article about the [`CurrentCellChanged` event in the .NET MAUI TreeDataGrid]({%slug treedatagrid-current-cell%}).
60+
61+
## Reordering the Column
62+
63+
The TreeDataGrid inherits the `ColumnReorderStarting`, `ColumnReordering`, `ColumnReorderCompleting`, and `ColumnReordered` events related to the column reordering operation. For more details, review the TreeDataGrid [Columns Reordering]({%slug treedatagrid-columns-reordering%}#events) article.
64+
65+
## Resizing the Column
66+
67+
The TreeDataGrid resizing feature exposes a `ColumnUserResizeCompleted` event which is invoked when a column is resized by user interaction. The `ColumnUserResizeCompleted` event handler receives the following parameters:
68+
* The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
69+
* A `ColumnUserResizeCompletedEventArgs` object, which provides the following properties:
70+
- `Column` (`DataGridColumn`)—Gets the previously `CurrentCell`.
71+
- `Width` (`double`)—Gets the width of the column that is resized.
72+
73+
## Additional Resources
74+
75+
- [.NET MAUI TreeDataGrid Product Page](https://www.telerik.com/maui-ui/treedatagrid)
76+
- [.NET MAUI TreeDataGrid Forum Page](https://www.telerik.com/forums/maui?tagId=1801)
77+
- [Telerik .NET MAUI Blogs](https://www.telerik.com/blogs/mobile-net-maui)
78+
- [Telerik .NET MAUI Roadmap](https://www.telerik.com/support/whats-new/maui-ui/roadmap)
79+
80+
## See Also
81+
82+
- [Setting the .NET MAUI TreeDataGrid Columns]({%slug treedatagrid-columns-overview%})
83+
- [Using the TreeDataGrid Commands]({%slug treedatagrid-aggregates%})
84+
- [Styling the Appearance of the TreeDataGrid]({%slug treedatagrid-styling%})
85+
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: Localization
3+
page_title: .NET MAUI TreeDataGrid Documentation - Localization
4+
description: Learn more about the MAUI localization keys and default values provided by the Telerik UI for .NET MAUI TreeDataGrid.
5+
position: 18
6+
tags: maui localization, maui, localization, dotnet maui
7+
slug: treedatagrid-localization
8+
---
9+
10+
# .NET MAUI TreeDataGrid Localization
11+
12+
The Telerik UI for .NET MAUI TreeDataGrid inherits the localization support from the DataGrid. You can translate the text displayed in the Filtering UI, etc. to other languages, so that your application can be adapted to different cultures.
13+
14+
>important For more details about the localization process of Telerik UI for .NET MAUI components, refer to the topic about [common globalization and localization support by Telerik UI for .NET MAUI]({%slug globalization-localization%}).
15+
16+
The table below shows the localization keys available for the TreeDataGrid control and their default values:
17+
18+
| Localization Key | Default Value |
19+
| ----------------- | ------------- |
20+
| `DataGrid_DistinctValues_null` | `(empty)` |
21+
| `DataGrid_DistinctValues_SelectAll` | `Select All` |
22+
| `DataGrid_Filter_ApplyFilter` | `Filter` |
23+
| `DataGrid_Filter_ResetFilter` | `Reset` |
24+
| `DataGrid_Filter_ShowRowsWithValueThat` | `Show rows with value that:` |
25+
| `DataGrid_FilterWatermarkText` | `Enter Filter Criteria` |
26+
| `DataGrid_LoadOnDemandButtonText` | `LOAD MORE` |
27+
| `DataGrid_LogicalOperator_And` | `And` |
28+
| `DataGrid_LogicalOperator_Or` | `Or` |
29+
| `DataGrid_NumericalOperator_EqualsTo` | `Is equal to` |
30+
| `DataGrid_NumericalOperator_DoesNotEqualTo` | `Is not equal to` |
31+
| `DataGrid_NumericalOperator_IsGreaterThan` | `Is greater than` |
32+
| `DataGrid_NumericalOperator_IsGreaterThanOrEqualTo` | `Is greater than or equal to` |
33+
| `DataGrid_NumericalOperator_IsLessThan` | `Is less than` |
34+
| `DataGrid_NumericalOperator_IsLessThanOrEqualTo` | `Is less than or equal to` |
35+
| `DataGrid_TextOperator_Contains` | `Contains` |
36+
| `DataGrid_TextOperator_DoesNotContain` | `Does not contain` |
37+
| `DataGrid_TextOperator_DoesNotEqualTo` | `Is not equal to` |
38+
| `DataGrid_TextOperator_EndsWith` | `Ends with` |
39+
| `DataGrid_TextOperator_EqualsTo` | `Is equal to` |
40+
| `DataGrid_TextOperator_IsEmpty` | `Is empty` |
41+
| `DataGrid_TextOperator_IsNotEmpty` | `Is not empty` |
42+
| `DataGrid_TextOperator_StartsWith` | `Starts with` |
43+
| `DataGrid_Search_SearchEntryPlaceholder` | `Type to Search` |
44+
| `DataGrid_Search_ApplyFilter` | `Filter Results` |
45+
| `DataGrid_Search_CaseSensitive` | `Match Case` |
46+
| `DataGrid_Search_Contains` | `Contains` |
47+
| `DataGrid_Search_MatchesNotfound` | `Not found` |
48+
| `DataGrid_Search_MatchesStringFormat` | `Matches: {0}` |
49+
| `DataGrid_Search_SearchEntryPlaceholder` | `Type to Search` |
50+
| `DataGrid_Search_WholeWord` | `Whole Word` |
51+
52+
## Additional Resources
53+
54+
- [.NET MAUI TreeDataGrid Product Page](https://www.telerik.com/maui-ui/treedatagrid)
55+
- [.NET MAUI TreeDataGrid Forum Page](https://www.telerik.com/forums/maui?tagId=1801)
56+
- [Telerik .NET MAUI Blogs](https://www.telerik.com/blogs/mobile-net-maui)
57+
- [Telerik .NET MAUI Roadmap](https://www.telerik.com/support/whats-new/maui-ui/roadmap)
58+
59+
## See Also
60+
61+
- [Sorting .NET MAUI DataGrid Records]({%slug treedatagrid-sorting%})
62+
- [Styling the Appearance of the DataGrid]({%slug treedatagrid-styling%})
63+
64+

0 commit comments

Comments
 (0)