Month View

Jun 04, 2025
2 minutes to read

The Month View displays the least amount of detail. It targets long-term planning and overview scenarios. Days are displayed horizontally in week rows, weeks are arranged vertically.

The MonthView class implements the Month View. Use the SchedulerControl.MonthView property to access this view.

Activate Moth View

Set the SchedulerControl.ActiveViewType property to SchedulerViewType.Month to active the Month View.

The following code snippet creates a SchedulerControl and activates the Month View:

csharp

using System;
using System.Windows.Forms;
using DevExpress.XtraScheduler;
namespace DXSchedulerApp {
    public partial class Form1 : DevExpress.XtraEditors.XtraForm {
        SchedulerControl schedulerControl;
        public Form1() {
            InitializeComponent();
            schedulerControl = new SchedulerControl() {
                Dock = DockStyle.Fill,
                Start = DateTime.Now,
                ActiveViewType = SchedulerViewType.Month,
                DataStorage = schedulerDataStorage1
            };
            this.Controls.Add(schedulerControl);
        }
    }
}

Month View API

Properties and Methods

Member Name	Description
MonthView.Appearance	Provides access to the properties that control the appearance of the MonthView’s elements.
SchedulerViewBase.AppointmentDisplayOptions	Provides access to the MonthViewAppointmentDisplayOptions instance containing appointment’s display options for the MonthView.
MonthView.CompressWeekend	Gets or sets a value indicating if the weekend days (Saturday and Sunday) should be displayed as one day.
SchedulerControl.SelectedInterval	Gets the time interval currently selected in the scheduler’s active view by an end-user.
MonthView.ShowWeekend	Gets or sets a value indicating if the scheduler should also show its data for the weekend days (Saturday and Sunday) in a Month View.
SchedulerViewBase.GetVisibleIntervals	Returns a copy of the visible time interval collection for the current view.
SchedulerViewBase.SetVisibleIntervals	Fills the visible time interval collection with new items.
MonthView.WeekCount	Gets or sets the number of weeks that are simultaneously displayed within the Week View.

Events

Event Name	Description
SchedulerControl.CustomDrawWeekViewTopLeftCorner	Fires when the SchedulerViewBase.GroupType is set to the SchedulerGroupType.Date. Allows you to manually paint square area at the left corner of the view.
SchedulerControl.CustomDrawDayOfWeekHeader	Allows you to manually paint Day of Week Headers.
SchedulerControl.CustomDrawGroupSeparator	Allows you to paint a Group Separator in a custom manner.
SchedulerControl.CustomDrawNavigationButton	Allows you to paint Navigation Buttons in a custom manner.
SchedulerControl.CustomDrawResourceHeader	Allows you to paint Resource Headers in a custom manner.
SchedulerControl.CustomDrawTimeCell	Allows you to paint the Time Cells in a custom manner.

Services

Service	Description
HeaderCaptionService	Allows you to custom format the header captions.
HeaderToolTipService	Allows you to specify custom tooltips for the day headers