Skip to content

Commit c5ca934

Browse files
committed
update message inside GS articles for TreeView, TDG and DG.
1 parent e132702 commit c5ca934

File tree

3 files changed

+21
-9
lines changed

3 files changed

+21
-9
lines changed

controls/datagrid/getting-started.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -63,10 +63,14 @@ public static class MauiProgram
6363

6464
## Visualize Sample Data
6565

66-
The DataGrid provides UI virtualization, so it requires its visual parent to provide vertical or horizontal space for the control to fit into. The following scenarios will measure the DataGrid with infinite width and height constraints and the virtualization will not work:
66+
The DataGrid uses UI virtualization and requires its parent container to provide a defined vertical or horizontal space. Virtualization will not work if the DataGrid is measured with infinite width or height.
6767

68-
* Positioning the DataGrid inside a `StackLayout` which is wrapped in a ScrollView.
69-
* Positioning the DataGrid inside a ScrollView.
68+
Avoid placing the DataGrid in the following layouts, as this will prevent virtualization from functioning:
69+
70+
* Do not place the DataGrid inside a `StackLayout` that is wrapped in a `ScrollView`.
71+
* Do not place the DataGrid directly inside a `ScrollView`.
72+
73+
Place the DataGrid control inside a `Grid` layout with a row height set to `*` (star) or a specific value.
7074

7175
Now that you have added the control to your view, you need to make sure that is properly loaded with the required data.
7276

controls/treedatagrid/getting-started.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,14 @@ Before adding the TreeDataGrid, you need to:
2626

2727
## Define the Control
2828

29-
The TreeDataGrid provides UI virtualization, so it requires its visual parent to provide vertical or horizontal space for the control to fit into. The following scenarios will measure the TreeDataGrid with infinite width and height constraints and the virtualization will not work:
29+
The TreeDataGrid uses UI virtualization and requires its parent container to provide a defined vertical or horizontal space. Virtualization will not work if the TreeDataGrid is measured with infinite width or height.
3030

31-
* Positioning the TreeDataGrid inside a `StackLayout` which is wrapped in a `ScrollView`.
32-
* Positioning the TreeDataGrid inside a `ScrollView` or controls with internal scrolling.
31+
Avoid placing the TreeDataGrid in the following layouts, as this will prevent virtualization from functioning:
32+
33+
* Do not place the TreeDataGrid inside a `StackLayout` that is wrapped in a `ScrollView`.
34+
* Do not place the TreeDataGrid directly inside a `ScrollView`.
35+
36+
Place the TreeDataGrid control inside a `Grid` layout with a row height set to `*` (star) or a specific value.
3337

3438
By default, the TreeDataGrid auto-generates rows depending on the number of objects in the collection set as its `ItemsSource`.
3539

controls/treeview/getting-started.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,14 @@ Before adding the TreeView, you need to:
3131

3232
When your .NET MAUI application is set up, you are ready to add a TreeView control to your page. The following example shows a sample TreeView definition populated with sample data.
3333

34-
The TreeView provides UI virtualization, which requires the visual parent to provide vertical or horizontal space. To avoid breaking UI virtualization or gesture mechanisms:
34+
The TreeView uses UI virtualization and requires its parent container to provide a defined vertical or horizontal space. Virtualization will not work if the TreeView is measured with infinite width or height.
3535

36-
* Do not place the TreeView inside a `StackLayout` or inside a `ScrollView`.
37-
* Do not set the TreeView to a `RowDefinition Height="Auto"` Grid definition.
36+
Avoid placing the TreeView in the following layouts, as this will prevent virtualization from functioning:
37+
38+
* Do not place the TreeView inside a `StackLayout` that is wrapped in a `ScrollView`.
39+
* Do not place the TreeView directly inside a `ScrollView`.
40+
41+
Place the TreeView control inside a `Grid` layout with a row height set to `*` (star) or a specific value.
3842

3943
**1.** Set up the `RadTreeView` instance:
4044

0 commit comments

Comments
 (0)