Class MonthViewSettings

Represents a class which is used to configure all the properties of MonthView.

Inheritance

System.Object

ViewSettingsBase

MonthViewSettings

Implements

System.IDisposable

Inherited Members

ViewSettingsBase.Dispose()

ViewSettingsBase.VisibleResourceCount

ViewSettingsBase.ResourceHeaderSize

ViewSettingsBase.AppointmentTemplate

ViewSettingsBase.AppointmentTemplateSelector

ViewSettingsBase.ViewHeaderDayFormat

ViewSettingsBase.ViewHeaderHeight

ViewSettingsBase.ViewHeaderTemplate

Namespace: Syncfusion.UI.Xaml.Scheduler

Assembly: Syncfusion.Scheduler.WinUI.dll

Syntax

public class MonthViewSettings : ViewSettingsBase, IDisposable

Constructors

MonthViewSettings()

Initializes a new instance of the MonthViewSettings class.

Declaration

public MonthViewSettings()

Properties

AgendaViewHeight

Gets or sets the Agenda view height.

Declaration

public double AgendaViewHeight { get; set; }

Property Value

Type	Description
System.Double

AppointmentDisplayCount

Gets or sets a value to define the maximum number of the appointment to be displayed in a month cell.

Declaration

public int AppointmentDisplayCount { get; set; }

Property Value

Type

Description

System.Int32

This property takes the AppointmentDisplayCount value. For AppointmentDisplayCount value is 1 and month cell have more than 1 appointments, single appointment will be displayed and remaining appointments in month cell displayed in more appointments count. If an AppointmentDisplayCount value is more than one, for an example value is 3 and month cell have more than 3 appointments, 2 appointments will be displayed and remaining appointments in month cell displayed in more appointments count.

AppointmentDisplayMode

Gets or sets a value which define the display mode for appointment in month view.

Declaration

public AppointmentDisplayMode AppointmentDisplayMode { get; set; }

Property Value

Type	Description
AppointmentDisplayMode

DateFormat

Gets or sets a date format.

Declaration

public string DateFormat { get; set; }

Property Value

Type	Description
System.String

Examples

The following sample used to set the date format.

#[C#](#tab/tabid-1)

this.Schedule.MonthViewSettings.DateFormat = "d"

#[Xaml](#tab/tabid-2)

<?xml version = "1.0" encoding="utf-8"?>
<syncfusion:SfScheduler x:Name="Schedule" >
   <syncfusion:SfScheduler.MonthViewSettings>
       <syncfusion:MonthViewSettings DateFormat = "d" />
  </ syncfusion:SfScheduler.MonthViewSettings>
</syncfusion:SfScheduler>

LeadingDaysVisibility

Gets or sets a value indicating whether leading days should be visible or not.

Declaration

public Visibility LeadingDaysVisibility { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Visibility

MonthCellTemplate

Gets or sets the month cell template.

Declaration

public DataTemplate MonthCellTemplate { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.DataTemplate

Examples

The following sample used to configure month cell.

#[Xaml](#tab/tabid-4)

<syncfusion:SfScheduler x:Name="Schedule">
   <syncfusion:SfScheduler.MonthViewSettings>
       <syncfusion:MonthViewSettings>
           <syncfusion:MonthViewSettings.MonthCellTemplate>
               <DataTemplate>
                  <Border Background = "BlueViolet" >
                    < TextBlock x:Name="DayText" HorizontalAlignment="Center"
                              Foreground="White" Text="{Binding DateTime.Day}"/>
                  </Border>
               </DataTemplate>
           </syncfusion:MonthViewSettings.MonthCellTemplate>
       </syncfusion:MonthViewSettings>
  </syncfusion:SfScheduler.MonthViewSettings>
</syncfusion:SfScheduler>

MonthCellTemplateSelector

Gets or sets the month cell template selector.

Declaration

public DataTemplateSelector MonthCellTemplateSelector { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Controls.DataTemplateSelector

Examples

The following sample used to configure month cell template selector.

#[DataTemplateSelector](#tab/tabid-5)

public class MonthCellTemplateSelector : DataTemplateSelector
{
public MonthCellTemplateSelector()
{
}
public DataTemplate NormalDayMonthCellTemplate { get; set; }
public DataTemplate CurrentDayMonthCellTemplate { get; set; }
protected override DataTemplate SelectTemplateCore(object item, DependencyObject container)
{
  var monthCell = container as MonthCell;
  if (monthCell != null)
  {
      if (monthCell.DateTime.Date == DateTime.Now.Date)
          return CurrentDayMonthCellTemplate;
   }
   return NormalDayMonthCellTemplate;
}
}

#[Resources](#tab/tabid-6)

<Window.Resources>
      <DataTemplate x:Key="monthCellTemplate1">
       <Border Background = "BlueViolet" >
           < TextBlock x:Name="DayText" HorizontalAlignment="Center" Foreground="White" Text="{Binding DateTime.Day}"/>
       </Border>
   </DataTemplate>
  <DataTemplate x:Key="monthCellTemplate2">
      <Border Background = "LightCyan" >
           < TextBlock x:Name="DayText" HorizontalAlignment="Center" Foreground="Red" Text="{Binding DateTime.Day}"/>
       </Border>
   </DataTemplate>
  <local:MonthCellTemplateSelector x:Key="monthCellTemplateSelector"
  NormalDayMonthCellTemplate="{StaticResource monthCellTemplate1}"
  CurrentDayMonthCellTemplate="{StaticResource monthCellTemplate2}" />
</Window.Resources>

#[MainWindow](#tab/tabid-7)

<syncfusion:SfScheduler x:Name="schedule">
       <syncfusion:SfScheduler.MonthViewSettings>
           <syncfusion:MonthViewSettings MonthCellTemplateSelector = "{StaticResource monthCellTemplateSelector}" />
       </ syncfusion:SfScheduler.MonthViewSettings>
</syncfusion:SfScheduler>

MonthNavigationDirection

Gets or sets a value which determines in which direction the MonthView scrolls.

Declaration

public Orientation MonthNavigationDirection { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Controls.Orientation

MoreAppointmentsIndicatorTemplate

Gets or sets the template for changing the default UI of the scheduler month view's more appointments indicator view in the month cell.

Declaration

public DataTemplate MoreAppointmentsIndicatorTemplate { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.DataTemplate

Remarks

The DataContext of the MoreAppointmentsIndicatorTemplate is an integer that denotes count of appointments not in view.

Examples

The following sample used to configure the more appointments indicator template.

#[C#](#tab/tabid-8)

var scheduleAppointments = new ScheduleAppointmentCollection();
for (int i = 0; i < 5; i++)
{
  var scheduleAppointment = new ScheduleAppointment()
  {
      Subject = "General Meeting",
      StartTime = new DateTime(2021, 04, 30, 09, 0, 0),
      EndTime = new DateTime(2021, 04, 30, 10, 0, 0),
      AppointmentBackground = new SolidColorBrush((Color)ColorConverter.ConvertFromString("#FFA2C139")),
      IsAllDay = true,
  };
  scheduleAppointments.Add(scheduleAppointment);
}
this.Schedule.ItemsSource = scheduleAppointments;

#[Xaml](#tab/tabid-9)

<syncfusion:SfScheduler x:Name="Schedule">
<syncfusion:SfScheduler.MonthViewSettings >
    <syncfusion:MonthViewSettings >
         <syncfusion:MonthViewSettings.MoreAppointmentsIndicatorTemplate >
             <DataTemplate>
                 <StackPanel Background="LightBlue" HorizontalAlignment="Stretch" VerticalAlignment="Stretch">
                    <TextBlock Text="{Binding}" Foreground="Black" TextAlignment="Left" VerticalAlignment="Center">
                     </TextBlock>
               </StackPanel>
           </DataTemplate>
               </ syncfusion:MonthViewSettings.MoreAppointmentsIndicatorTemplate >
            </ syncfusion:MonthViewSettings >
         </ syncfusion:SfScheduler.MonthViewSettings >
 </syncfusion:SfScheduler>

ShowAgendaView

Gets or sets a value indicating whether agenda view should be visible or not.

Declaration

public bool ShowAgendaView { get; set; }

Property Value

Type	Description
System.Boolean

ShowWeekNumber

Gets or sets a value indicating whether week number should be shown or not.

Declaration

public bool ShowWeekNumber { get; set; }

Property Value

Type	Description
System.Boolean

TrailingDaysVisibility

Gets or sets a value indicating whether trailing days should be visible or not.

Declaration

public Visibility TrailingDaysVisibility { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Visibility

WeekNumberTemplate

Gets or sets the week number template.

Declaration

public DataTemplate WeekNumberTemplate { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.DataTemplate

Examples

The following sample used to configure the week number template.

#[Xaml](#tab/tabid-3)

<syncfusion:SfScheduler x:Name="Schedule">
   <syncfusion:SfScheduler.MonthViewSettings>
       <syncfusion:MonthViewSettings>
           <syncfusion:MonthViewSettings.WeekNumberTemplate>
              <DataTemplate>
                   <Grid >
                       <TextBlock Foreground = "Red" Text="{Binding}"
                                  VerticalAlignment="Center" HorizontalAlignment="Center"/>
                   </Grid>
               </DataTemplate>
           </syncfusion:MonthViewSettings.WeekNumberTemplate>
       </syncfusion:MonthViewSettings>
  </syncfusion:SfScheduler.MonthViewSettings>
</syncfusion:SfScheduler>

Methods

Dispose(Boolean)

Disposes all the resources used by the MonthViewSettings class.

Declaration

protected override void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing	Indicates whether the call is from Dispose method or from a System.GC.SuppressFinalize(System.Object).

Overrides

ViewSettingsBase.Dispose(Boolean)

Implements

System.IDisposable