Version

CalendarDimensions Property

Returns or sets a value indicating the preferred rows and columns of groups to be displayed within the control.
Syntax
'Declaration
 
Public Property CalendarDimensions As CalendarDimensions
public CalendarDimensions CalendarDimensions {get; set;}
Remarks

The CalendarDimensions is used by the CalendarItemGroupPanel within the template of the XamMonthCalendar to determine the minimum number of rows and columns of CalendarItemGroup instances that it should create and arrange. If the AutoAdjustCalendarDimensions is true, which is the default value, and the CalendarItemGroupPanel has space to display mode groups it will automatically create additional groups up to its MaxGroups.

If you retemplate the XamMonthCalendar such that it does not contain a CalendarItemGroupPanel, this property will not affect the display of the control.

Example
This sample demonstrates how to create and initialize a new XamMonthCalendar.

Imports Infragistics.Windows.Editors
Imports Infragistics.Windows.Controls

    Private Sub InitializeCalendar(ByVal calendar As XamMonthCalendar)
        ' by default the template of the xammonthcalendar uses a calendaritemgrouppanel
        ' which will automatically create groups as needed based on the available size
        ' to use a fixed size, you can set AutoAdjustCalendarDimensions to false and 
        ' set the CalendarDimensions to the dimensions you want it to always use
        calendar.AutoAdjustCalendarDimensions = False
        calendar.CalendarDimensions = New CalendarDimensions(2, 2)

        ' DisabledDaysOfWeek is a flagged enumeration of the days of the week
        ' that should be disabled and therefore disallow activation and selection
        calendar.DisabledDaysOfWeek = DayOfWeekFlags.Saturday Or DayOfWeekFlags.Sunday

        ' the default selection type allows for selection of multiple dates
        calendar.SelectionType = SelectionType.Single

        ' the min/max dates control the range of dates that are available
        ' for activation/selection. any dates outside this range will not
        ' be shown
        calendar.MinDate = New DateTime(2008, 1, 1)
        calendar.MaxDate = New DateTime(2099, 12, 31)

        ' by default week numbers are not displayed
        calendar.WeekNumberVisibility = Visibility.Visible

        ' the today button that is used to select the current date
        ' can be removed using the TodayButtonVisibility
        calendar.TodayButtonVisibility = Visibility.Collapsed

        ' by default leading and trailing dates (e.g. days before
        ' and after the first/last visible month) are displayed
        ' within the control
        calendar.ShowLeadingAndTrailingDates = False
    End Sub
using Infragistics.Windows.Editors;
using Infragistics.Windows.Controls;

        private void InitializeCalendar(XamMonthCalendar calendar)
        {
            // by default the template of the xammonthcalendar uses a calendaritemgrouppanel
            // which will automatically create groups as needed based on the available size
            // to use a fixed size, you can set AutoAdjustCalendarDimensions to false and 
            // set the CalendarDimensions to the dimensions you want it to always use
            calendar.AutoAdjustCalendarDimensions = false;
            calendar.CalendarDimensions = new CalendarDimensions(2, 2);

            // DisabledDaysOfWeek is a flagged enumeration of the days of the week
            // that should be disabled and therefore disallow activation and selection
            calendar.DisabledDaysOfWeek = DayOfWeekFlags.Saturday | DayOfWeekFlags.Sunday;

            // the default selection type allows for selection of multiple dates
            calendar.SelectionType = SelectionType.Single;

            // the min/max dates control the range of dates that are available
            // for activation/selection. any dates outside this range will not
            // be shown
            calendar.MinDate = new DateTime(2008, 1, 1);
            calendar.MaxDate = new DateTime(2099, 12, 31);

            // by default week numbers are not displayed
            calendar.WeekNumberVisibility = Visibility.Visible;

            // the today button that is used to select the current date
            // can be removed using the TodayButtonVisibility
            calendar.TodayButtonVisibility = Visibility.Collapsed;

            // by default leading and trailing dates (e.g. days before
            // and after the first/last visible month) are displayed
            // within the control
            calendar.ShowLeadingAndTrailingDates = false;
        }
<UserControl x:Class="Xaml.UserControl1"
    
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    
xmlns:igEditors="http://infragistics.com/Editors"
    
xmlns:igThemes="http://infragistics.com/Themes">
    
<igEditors:XamMonthCalendar
        
x:Name="xamMonthCalendar1"
        
AutoAdjustCalendarDimensions="False"
        
CalendarDimensions="2,2"
        
DisabledDaysOfWeek="Saturday, Sunday"
        
SelectionType="Single"
        
MinDate="1/1/2000"
        
MaxDate="12/31/2099"
        
WeekNumberVisibility="Visible"
        
TodayButtonVisibility="Collapsed"
        
ShowLeadingAndTrailingDates="False" />
</UserControl>
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also