merge master into dev

controls/button/getting-started.md

@@ -8,7 +8,7 @@ slug: button-getting-started
 
 # Getting Started with the .NET MAUI Button
 
-This guide provides the information you need to start using the Telerik UI for .NET MAUI Button by adding the control to your project.
+This guide provides the information you need to start using the Telerik UI for [.NET MAUI Button]({%slug button-overview%}) by adding the control to your project.
 
 {% if site.has_cta_panels == true %}
 {% include cta-panel-maui-overview.html %}

controls/collectionview/item-swipe/item-swipe-commands.md

@@ -7,7 +7,7 @@ slug: collectionview-item-swipe-commands
 tags: item-swipe, collectionview, swiping, commands
 ---
 
-## .NET MAUI CollectionView Swiping Commands
+# .NET MAUI CollectionView Swiping Commands
 
 The .NET MAUI CollectionView provides the following commands related to swipe actions:
 

controls/collectionview/item-swipe/item-swipe-events.md

@@ -7,7 +7,7 @@ slug: collectionview-item-swipe-events
 tags: item-swipe, collectionview, swiping, events
 ---
 
-## .NET MAUI CollectionView Swiping Events
+# .NET MAUI CollectionView Swiping Events
 
 The following `RadCollectionView` events are related to the item swiping feature:
 

controls/datagrid/aggregates/delegate-aggregate-descriptor.md

@@ -19,7 +19,7 @@ To set up the `DelegateAggregateDescriptor`, use the following properties:
 
 The following example uses the `DelegateAggregateDescriptor` and a custom implementation for a `SumIf` function which sums the values in a range that meet a certain criteria:
 
-**1.** Create a class that inherits from the `IKeyLookup` interface. It will return the values of a `Price` property declared in our business model that is of type `double`.
+**1.** Create a class that inherits from the `IKeyLookup` interface. It returns the values of a `Price` property declared in the business model that is of type `double`.
 
 <snippet id='datagrid-delegate-aggregate-key'/>
 
@@ -35,7 +35,7 @@ The following example uses the `DelegateAggregateDescriptor` and a custom implem
 
 <snippet id='datagrid-aggregates-model'/>
 
-**5.** Set a source to the `RadDataGrid.ItemsSource` proeprty:
+**5.** Set a source to the `RadDataGrid.ItemsSource` property:
 
 <snippet id='datagrid-gelegate-aggregate-source'/>
 

controls/datagrid/aggregates/overview.md

@@ -42,7 +42,7 @@ To show the Aggregates in the group header, set the `ShowGroupHeaderAggregates`
 
 ![DataGrid Group Header Aggregate](../images/datagrid-group-header-aggregate.png)
 
-To align the aggregates in the group according to its header set the `GroupAggregatesAlignment` (`enum` of type `Telerik.Maui.Controls.DataGrid.DataGridGroupAggregatesAlignment`) property. The available options are:
+To align the aggregates in the group according to its header, set the `GroupAggregatesAlignment` (`enum` of type `Telerik.Maui.Controls.DataGrid.DataGridGroupAggregatesAlignment`) property. The available options are:
 
 * (default)`None`—Aggregates are not aligned to the DataGrid columns. The aggregates results are displayed after the text displayed for the group key.
 * `NextToHeader`—Aggregate results are aligned to the DataGrid columns and placed next to the header of the group.
@@ -60,4 +60,4 @@ To visualize the group footer, set the `ShowGroupFooters` property to `True`. Th
 ## See Also
 
 - [Property Aggregate Descriptor]({%slug datagrid-property-aggregate-descriptor%})
-- [Delegate Aggregate Descriptor]({%slug datagrid-delegate-aggregate-descriptor%})
+- [Delegate Aggregate Descriptor]({%slug datagrid-delegate-aggregate-descriptor%})

controls/datagrid/aggregates/property-aggregate-descriptor.md

@@ -32,7 +32,7 @@ The `PropertyAggregateDescriptor` supports the following `KnownFunction` aggrega
 
 The following example shows how to add a `PropertyAggregateDescriptor` to the DataGrid's columns.
 
-The DataGrid will take the values from the `Name`, `Price`, `DeliveryPrice` and `Quantity` properties of the row model and the result will be the `Min`, `Max`, and `Average` delivery prices, as well as the `Count` of the listed items.
+The DataGrid takes the values from the `Name`, `Price`, `DeliveryPrice` and `Quantity` properties of the row model and the result will be the `Min`, `Max`, and `Average` delivery prices, as well as the `Count` of the listed items.
 
 **1.** Define the DataGrid in XAML:
 

controls/datagrid/aggregates/styling.md

@@ -28,7 +28,7 @@ Use the following properties to style the `GroupHeader`:
 | `ButtonFontSize` | Defines the font size for the expand/collapse symbol of the `GroupHeader`. |
 | `ButtonMargin` | Defines the margin for the expand/collapse symbol of the `GroupHeader`. |
 | `ButtonTextColor` | Defines the color for the expand/collapse symbol of the `GroupHeader`. |
-| `TextColor` | Defines the color for the text part of the `GroupHeader` |
+| `TextColor` | Defines the color for the text part of the `GroupHeader`. |
 | `TextFontAttributes` | Defines the font attributes for the text part of the `GroupHeader`. |
 | `TextFontFamily` | Defines the font family for the text part of the `GroupHeader`. |
 | `TextFontSize` | Defines the size for the text part of the `GroupHeader`. |
@@ -44,11 +44,11 @@ The available properties in the `GroupHeaderStyle` are:
 
 | Property  | Description |
 | ------ | ------ |
-| `AggregatesTextColor` | Defines the color for the aggregates part of the `GroupHeader` |
-| `AggregatesTextFontAttributes` | Defines the font attributes for the aggregates part of the `GroupHeader` |
-| `AggregatesTextFontFamily` | Defines the font family of the aggregates part of the `GroupHeader` |
-| `AggregatesTextFontSize` | Defines the size of the aggregates part of the `GroupHeader` |
-| `AggregatesTextMargin` | Defines the margin for the aggregates part of the `GroupHeader` |
+| `AggregatesTextColor` | Defines the color for the aggregates part of the `GroupHeader`. |
+| `AggregatesTextFontAttributes` | Defines the font attributes for the aggregates part of the `GroupHeader`. |
+| `AggregatesTextFontFamily` | Defines the font family of the aggregates part of the `GroupHeader`. |
+| `AggregatesTextFontSize` | Defines the size of the aggregates part of the `GroupHeader`. |
+| `AggregatesTextMargin` | Defines the margin for the aggregates part of the `GroupHeader`. |
 
 The following example shows how to style the aggregate results in the group header when setting the `GroupHeaderStyle` in the page's resources:
 
@@ -167,4 +167,4 @@ The following image shows the end result.
 ## See Also
 
 - [Property Aggregate Descriptor]({%slug datagrid-property-aggregate-descriptor%})
-- [Delegate Aggregate Descriptor]({%slug datagrid-delegate-aggregate-descriptor%})
+- [Delegate Aggregate Descriptor]({%slug datagrid-delegate-aggregate-descriptor%})

controls/datagrid/overview.md

@@ -10,7 +10,7 @@ slug: datagrid-overview
 
 # .NET MAUI DataGrid Overview
 
-The Telerik UI for .NET MAUI DataGrid is a powerful control that allows you to visualize and edit tabular represented data in your .NET MAUI applications.
+The Telerik UI for [.NET MAUI DataGrid](https://www.telerik.com/maui-ui/datagrid) is a powerful control that allows you to visualize and edit tabular represented data in your .NET MAUI applications.
 
 Most of the data on the Internet is stored in tables within a database. The Telerik UI for .NET MAUI DataGrid provides the same abstraction over the data—It has columns and rows, and the intersection of a row and a column is called a cell.
 
@@ -109,3 +109,18 @@ The Telerik UI for .NET MAUI DataGrid provides [localization support]({%slug glo
 - [.NET MAUI DataGrid Forum Page](https://www.telerik.com/forums/maui?tagId=1801)
 - [Telerik .NET MAUI Blogs](https://www.telerik.com/blogs/mobile-net-maui)
 - [Telerik .NET MAUI Roadmap](https://www.telerik.com/support/whats-new/maui-ui/roadmap)
+
+
+<script type="application/ld+json"> 
+{ 
+  "@context": "https://schema.org", 
+  "@type": "VideoObject", 
+  "name": "Mastering the DataGrid in Telerik UI for .NET MAUI: Setup, Columns, Sorting, and More | Chapter 4", 
+  "description": "Take your .NET MAUI skills to the next level with Chapter 4 of the Telerik UI for .NET MAUI course! This video provides a comprehensive guide to .NET MAUI Grid control. Learn about its features, setup process, column configuration, and creating custom column templates. Discover how to enable sorting, filtering, and selection for a dynamic and powerful data presentation in your apps. Watch now and become a DataGrid expert!", 
+  "thumbnailUrl": "https://img.youtube.com/vi/XxUvA4fKHzU/maxresdefault.jpg", 
+  "uploadDate": "2024-12-05", 
+  "duration": "PT20M27S", 
+  "contentUrl": "https://youtu.be/XxUvA4fKHzU", 
+  "embedUrl": "https://www.youtube.com/embed/XxUvA4fKHzU" 
+} 
+</script> 

controls/datepicker/styling/styling.md

@@ -8,7 +8,7 @@ slug: datepicker-styling
 
 # Styling the .NET MAUI DatePicker
 
-The DatePicker control for .NET MAUI provides styling options for customizing its appearance. You can style the DatePicker itself, as well as its popup or drop-down depending on the configuration of the [picker mode]({%slug datepicker-picker-mode%}).
+The DatePicker control for .NET MAUI provides styling options for customizing its appearance. You can style the .NET MAUI DatePicker, as well as its popup or drop-down depending on the configuration of the [picker mode]({%slug datepicker-picker-mode%}).
 
 {% if site.has_cta_panels == true %}
 {% include cta-panel-maui-overview.html %}

controls/imageeditor/saving-image.md

@@ -6,7 +6,7 @@ position: 5
 slug: imageeditor-saving-image
 ---
 
-## Saving Images with .NET MAUI ImageEditor
+# Saving Images with .NET MAUI ImageEditor
 
 `RadImageEditor` control gives you the option to save the currently edited image using the `SaveAsync` method. The `SaveAsync` method has the following overloads:
 

controls/path/styling.md

@@ -22,7 +22,7 @@ The `RadPath` element exposes the following properties you can use to customize
 <telerik:RadPath x:Name="gradientPath"
                             StrokeThickness="1"
                             Stroke="White"
-                            Geometry="{x:Static telerikInput:Geometries.Diamond}">
+                            Geometry="{x:Static telerik:RadGeometry.Diamond}">
     <telerik:RadPath.Fill>
         <telerik:RadSweepGradientBrush>
             <x:Arguments>

controls/pdfviewer/display-documents.md

@@ -6,7 +6,7 @@ position: 3
 slug: pdfviewer-display-documents
 ---
 
-## PDF Document Visualization
+# PDF Document Visualization
 
 The Telerik UI for .NET MAUI PDF Viewer control enables you to visualize PDF documents through the `Source` property of type `Telerik.Maui.Controls.PdfViewer.DocumentSource`. 
 

controls/pdfviewer/layout-mode.md

@@ -6,7 +6,7 @@ position: 4
 slug: pdfviewer-layout-modes
 ---
 
-## Layout Modes
+# Layout Modes
 
 The Telerik UI for .NET MAUI PDF Viewer supports two layout modes that you can set through its `LayoutMode` property.
 

controls/richtexteditor/overview.md

@@ -1,6 +1,6 @@
 ---
 title: Overview
-page_title: NET MAUI Rich Text Editor | Telerik UI for .NET MAUI
+page_title: NET MAUI Rich Text Editor
 description: NET MAUI Rich Text Editor enables formatted text editing with support for styling, links, and images in mobile and desktop apps.
 position: 0
 tags: dotnet maui editor, rich text editor

controls/richtexteditor/styling/toolbar-styling.md

@@ -6,7 +6,7 @@ position: 2
 slug: richtexteditor-toolbar-styling
 ---
 
-## RichTextEditor Toolbar Styling
+# RichTextEditor Toolbar Styling
 
 The [.NET MAUI RichTextEditor]({%slug richtexteditor-overview%}) provides a flexible styling API for its toolbar items. 
 

controls/timepicker/getting-started.md

@@ -29,24 +29,24 @@ Before adding the TimePicker, you need to:
 
 **1.** When your .NET MAUI application is set up, you are ready to add a TimePicker control to your page.
 
- ```XAML
+```XAML
 <telerik:RadTimePicker />
- ```
- <snippet id='timepicker-getting-started-csharp' />
+```
+<snippet id='timepicker-getting-started-csharp' />
 
 
 **2.** Add the following namespace:
 
- ```XAML
+```XAML
 xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
- ```
+```
 
 **3.** Register the Telerik controls through the `Telerik.Maui.Controls.Compatibility.UseTelerik` extension method called inside the `CreateMauiApp` method of the `MauiProgram.cs` file of your project:
 
- ```C#
- using Telerik.Maui.Controls.Compatibility;
+```C#
+using Telerik.Maui.Controls.Compatibility;
 
- public static class MauiProgram
+public static class MauiProgram
 {
 	public static MauiApp CreateMauiApp()
 	{
@@ -61,8 +61,8 @@ xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
 
 		return builder.Build();
 	}
- }           
- ```
+}
+```
 
 ## Additional Resources
 

controls/timepicker/localization.md

@@ -6,7 +6,7 @@ position: 8
 slug: timepicker-localization
 ---
 
-# Тime Picker Localization
+# TimePicker Localization
 
 The TimePicker for .NET MAUI provides language localization. The localization keys are described in the tables below:
 

controls/treeview/checkboxes.md

@@ -18,6 +18,15 @@ You can control the state propagation by setting the `CheckBoxMode` property (en
 * `Independent`—Specifies that the checkboxes are checked and unchecked independently. The checked state of the parent item is not propagated to its children.
 * `Recursive`—Specifies that the checkboxes are checked and unchecked recursively. The checked state of the parent item is propagated to its children.
 
+## Recursive CheckBox Mode and Load Children on Demand
+
+Consider the following scenarios when using the TreeView `Recursive` `CheckBoxMode` in a combination with the `LoadChildrenOnDemand` feature:
+
+* When checking the checkbox element of the parent item without loading the children, this parent item is added to the `CheckedItems` collection (the children are not).
+* When loading the children of the parent node by pressing the expand icon, and the checkbox of the parent node is checked, all child data items must be manually added to the `CheckedItems` collection.
+
+> For a runnable example demonstrating the TreeView `Recursive` `CheckBoxMode` and Load Children on Demand scenario, see the [Handling TreeView Load Children on Demand with Recursive CheckBox Mode]({%slug treeview-net-maui-load-children-checkbox-recursive%}) article.
+
 Here is how the Independent `CheckBoxMode` looks:
 
 ![.NET MAUI TreeView Independent Mode](images/treeview-independent-mode.gif)

controls/treeview/load-children-on-demand.md

@@ -18,6 +18,15 @@ To enable the TreeView Load Children on Demand feature:
 
 **2.** Use the `LoadChildrenOnDemand` event or `LoadChildrenOnDemandCommand` command to load the items.
 
+## Load Children on Demand and Recursive CheckBox Mode
+
+Consider the following scenarios when using the TreeView `LoadChildrenOnDemand` feature in a combination with the `Recursive` `CheckBoxMode`:
+
+* When checking the checkbox element of the parent item without loading the children, this parent item is added to the `CheckedItems` collection (the children are not).
+* When loading the children of the parent node by pressing the expand icon, and the checkbox of the parent node is checked, all child data items must be manually added to the `CheckedItems` collection.
+
+> For a runnable example demonstrating the TreeView `Recursive` `CheckBoxMode` and Load Children on Demand scenario, see the [Handling TreeView Load Children on Demand with Recursive CheckBox Mode]({%slug treeview-net-maui-load-children-checkbox-recursive%}) article.
+
 ## Event
 
 The TreeView exposes the following event for loading children on demand. 

controls/treeview/templates/item-template.md

@@ -24,7 +24,6 @@ The examples below shows how to define custom `ItemTemplate` by using the `ItemT
 <telerik:RadTreeView x:Name="treeView" 
                         ItemsSource="{Binding Items}">
     <telerik:TreeViewDescriptor ItemsSourcePath="Children"
-                                DisplayMemberPath="Name"
                                 TargetType="{x:Type local:Item}" />
     <!-- modify the label and add additional elements in the label area.
 ItemTemplate does not include expand indicator, image, checkbox, only the text, you can add additional elements to it.

installation/licensing/license-errors-warnings.md

@@ -28,14 +28,16 @@ When using Telerik UI for .NET MAUI in a project with an expired or missing lice
 
 | Error or Condition                              | Message Code | Solution                                                              |
 |-------------------------------------------------|--------------|-----------------------------------------------------------------------|
-| `No license key is detected` | TKL002 | [Set up a license key]({%slug set-up-your-license%}) to activate the UI controls and remove the error message. |
-| `Invalid license key` | TKL003 | [Download a new license key]({%slug set-up-your-license%}#downloading-the-license-key) and use it to activate the UI controls and remove the error message. |
-| `Your subscription license has expired.` | TKL103; TKL104 | Renew your subscription and [download a new license key]({%slug set-up-your-license%}#downloading-the-license-key). |
-| `Your perpetual license is invalid.` | TKL102 | You are using a product version released outside the validity period of your perpetual license. To remove the error message, do either of the following: |
+| `No Telerik and Kendo UI License file found` | TKL002 | [Set up a license key]({%slug set-up-your-license%}) to activate the UI controls and remove the error message. |
+| `Corrupted Telerik and Kendo UI License Key content` | TKL003 | [Download a new license key]({%slug set-up-your-license%}#downloading-the-license-key) and use it to activate the UI controls and remove the error message. |
+| `Unable to locate licenses for all products` | TKL004 | Your license is not valid for all Telerik and Kendo products added to your project. If you have already purchased the required license, then [update your license key]({%slug set-up-your-license%}#updating-your-license-key). |
+| `Your subscription has expired.` | TKL103; TKL104 | Renew your subscription and [download a new license key]({%slug set-up-your-license%}#downloading-the-license-key). |
+| `Your current license has expired.` | TKL102 | You are using a product version released outside the validity period of your perpetual license. To remove the error message, do either of the following: |
 |                                        | | - Renew your license, then download a new license key and use it to activate the controls. |
 |                                        | | - Downgrade to a product version included in your perpetual license as indicated in the message. |
-| `Your trial license has expired.`        | TKL105 | Purchase a commercial license to continue using the product. |
-| `Your license is not valid for the detected product(s).` | TKL101 | Review the purchase options for the listed products. Alternatively, remove the references to the listed packages from `package.json`. |
+| `Your trial expired.`        | TKL105 | Purchase a commercial license to continue using the product. |
+| `Telerik UI for .NET MAUI is not listed in your current license file.` | TKL101 | Review the purchase options for the listed products. Alternatively, remove the references to the listed packages from `package.json`. |
+| `No Telerik or Kendo UI product references detected in project.` | TKL001 | If you use Telerik products and see this message, update the `Telerik.Licensing` package to version `1.4.9` or later. If you do not use Telerik products, remove the `Telerik.Licensing` NuGet reference from your project. |
 
 ## See Also