Add scheduler agnda view

Author: didiyordanova

controls/scheduler/commands.md

@@ -30,6 +30,8 @@ Check below a quick example on how to utilize navigation commands:
 
 ## User Actions Commands
 
+* `AddAppointmentCommand` (`ICommand`)—Defines the command that is executed when the add appointment button is clicked. This command opens the appointment creation dialog.
+
 * `AppointmentTapCommand` (`ICommand`)—Defines the command that is executed when an appointment is tapped.
 
 * `AppointmentDoubleTapCommand` (`ICommand`)—Defines the command that is executed when an appointment is double tapped.
@@ -40,7 +42,21 @@ Check below a quick example on how to utilize navigation commands:
 
 * `MonthDayTapCommand` (`ICommand`)—Defines the command that is executed when a month day is tapped.
 
-* `MonthDayDoubleTapCommand` (`ICommand`)—Defines the command that is executed when a a month day is double tapped.
+* `MonthDayDoubleTapCommand` (`ICommand`)—Defines the command that is executed when a month day is double tapped.
+
+* `AgendaItemTapCommand`(`ICommand`)—Defines the command that is executed when an agenda item is tapped. Applicable only for the `Agenda` view. The command parameter is a `SchedulerNode` object representing the tapped agenda item. The items are: 
+
+  - `AgendaMonthNode`—Represents the model for month group headers in the agenda view.
+  - `AgendaWeekNode`—Represents the model for week group headers in the agenda view.
+  - `AgendaDayNode`—Represents the model for day group headers in the agenda view
+  - `AppointmentNode`—Represents the model of the views that are used to visualize appointments.
+
+* `AgendaItemDoubleTapCommand`(`ICommand`)—Defines the command that is executed when an agenda item is double tapped. Applicable only for the `Agenda` view. The command parameter is a `SchedulerNode` object representing the double-tapped agenda item. The items are: 
+
+  - `AgendaMonthNode`—Represents the model for month group headers in the agenda view.
+  - `AgendaWeekNode`—Represents the model for week group headers in the agenda view.
+  - `AgendaDayNode`—Represents the model for day group headers in the agenda view
+  - `AppointmentNode`—Represents the model of the views that are used to visualize appointments.
 
 ## See Also
 

controls/scheduler/date.md

@@ -0,0 +1,21 @@
+---
+title: Date Properties
+page_title: .NET MAUI Scheduler Documentation - Date Properties
+description: Learn more about the date properties of the Telerik UI for .NET MAUI Scheduler control.
+position: 3
+slug: scheduler-date
+---
+
+# .NET MAUI Scheduler Date Properties
+
+The .NET MAUI Scheduler exposes several date-related properties that you can use to work with dates in the active view.
+
+* `MinDate` (`DateTime`)—Defines the minimum date that can be navigated to in the scheduler. This property restricts backward navigation and prevents displaying dates earlier than the specified minimum. The default value is `2000, 1, 1`.
+* `MaxDate` (`DateTime`)—Defines the maximum date that can be navigated to in the scheduler. This property restricts forward navigation and prevents displaying dates later than the specified maximum. The default value is `2099, 12, 31`.
+* `CurrentDate` (`DateTime`)—Defines the primary date that determines the visible range of the scheduler. The actual visible range depends on the active view definition. For example, in `WeekView`, this date determines which week is displayed; in `MonthView`, which month is shown. The default value is today's date.
+
+## See Also
+
+- [Views]({% slug scheduler-views-overview %})
+- [Month View]({%slug scheduler-month-view%})
+- [MultiDay View]({%slug scheduler-multiday-view%})

controls/scheduler/events.md

@@ -31,6 +31,22 @@ Here is a list of the available events:
     * The sender argument, which is of type `object`, but can be cast to the `RadScheduler` type.
     * A `TappedEventArgs<DateTime>` object which provides the month day through its `Data` property.
 
+* `AgendaItemTapped`&mdash;occurs when the user taps on an agenda item. This event only applies to `Agenda` view and is not raised in `Day`, `Week`, `Month`, or `Multiday` views. The `AgendaItemTapped` event handler receives two parameters:
+    * The sender argument, which is of type `object`, but can be cast to the `RadScheduler` type.
+    * A `TappedEventArgs<SchedulerNode>` object which provides the agenda item occurrence through its `Data` property. The `Data` property can be one of the following types:
+        * `AgendaMonthNode`&mdash;Represents the model for month group headers in the agenda view.
+        * `AgendaWeekNode`&mdash;Represents the model for week group headers in the agenda view.
+        * `AgendaDayNode`&mdash;Represents the model for day group headers in the agenda view.
+        * `AppointmentNode`&mdash;Represents the model of the views that are used to visualize appointments.
+
+* `AgendaItemDoubleTapped`&mdash;occurs when the user taps on an agenda item. This event only applies to `Agenda` view and is not raised in `Day`, `Week`, `Month`, or `Multiday` views. The `AgendaItemTapped` event handler receives two parameters:
+    * The sender argument, which is of type `object`, but can be cast to the `RadScheduler` type.
+    * A `TappedEventArgs<SchedulerNode>` object which provides the agenda item occurrence through its `Data` property. The `Data` property can be one of the following types:
+        * `AgendaMonthNode`&mdash;Represents the model for month group headers in the agenda view.
+        * `AgendaWeekNode`&mdash;Represents the model for week group headers in the agenda view.
+        * `AgendaDayNode`&mdash;Represents the model for day group headers in the agenda view.
+        * `AppointmentNode`&mdash;Represents the model of the views that are used to visualize appointments.
+
 ## See Also
 
 - [Views]({% slug scheduler-views-overview %})

controls/scheduler/styling/agenda-styling.md

@@ -0,0 +1,46 @@
+---
+title: Agenda Styling
+page_title: .NET MAUI Scheduler Documentation - Agenda Styling
+description: Learn how to style the agenda view of the Telerik .NET MAUI Scheduler control.
+position: 3
+slug: scheduler-agenda-styling
+---
+
+# .NET MAUI Scheduler Agenda Styling
+
+Use the following properties of the `AgendaViewDefinition` to customize the appearance of the agenda view:
+
+* `MonthTemplate` (`DataTemplate`)—Specifies the template used to display month headers in the agenda view.
+* `WeekTemplate` (`DataTemplate`)—Specifies the template used to display week headers in the agenda view.
+* `DayTemplate` (`DataTemplate`)—Specifies the template used to display day headers in the agenda view.
+* `AppointmentDurationTemplate` (`DataTemplate`)—Specifies the template used to display appointment duration in the agenda view.
+* `InitializationBusyIndicatorStyle` (`Style` with target type `RadBusyIndicator`)—Specifies the style for the busy indicator shown during initial data loading. This indicator appears centered on screen while the agenda items are being loaded and until scroll is performed to the current item.
+* `LoadingProgressIndicatorStyle` (`Style` with target type `RadLinearProgressBar`)—Specifies the style applied to the progress bar displayed when loading appointments for the visible range.
+
+Here is an example of how to define custom templates in the Agenda View:
+
+1. Define the Agenda View in XAML:
+
+<snippet id='scheduler-agendaview-templates'/>
+
+2. Add the templates to the page's resources:
+
+<snippet id='scheduler-agenda-templates'/>
+
+3. Add the `telerik` namespace:
+
+```XAML
+xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
+```
+
+4. Add a `ViewModel` for the `AppointmentSource`:
+
+<snippet id='agenda-view-viewmodel'/>
+
+This is the result on WinUI:
+
+![.NET MAUI Scheduler Agenda View Styling](images/agendaview-styling.png)
+
+## See Also
+
+- [Views]({% slug scheduler-views-overview %})

controls/scheduler/styling/images/agendaview-styling.png

@@ -24,7 +24,12 @@ Add a `AgendaViewDefinition` to the `ViewDefinitions` collection of the `RadSche
 
 ![.NET MAUI Scheduler Agenda View](../images/scheduler-agendaview.png)
 
-## Properties
+## Properties on Scheduler Level
+
+* `AddAppointmentCommand` (`ICommand`)—Defines the command that is executed when the add appointment button is clicked. This command opens the appointment creation dialog.
+* `AddAppointmentButtonStyle` (`Style` with target type `RadButton`)—Defines the style that is applied to the add appointment button displayed in the Scheduler header. The button is visible for the `Agenda` view.
+
+## Properties on Agenda View Level
 
 * `Title` (`string`)—Specifies the name for the view. If not explicitly set, a default title may be generated.
 * `HeaderTextFormat` (`string`)—Defines the string format of the header text.