ClassMonthViewAreaElement
Represents the main content area in SchedulerMonthViewElement that contains the calendar grid with day cells and appointment displays, providing the primary interaction surface for month view scheduling.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.Scheduler.dll
Syntax:
public class MonthViewAreaElement : SchedulerCellContainer, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProviderInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementSchedulerVisualElementSchedulerCellContainerMonthViewAreaElement
Implements:
Inherited Members
Constructors
MonthViewAreaElement(RadScheduler, SchedulerView, SchedulerMonthViewElement)
Initializes a new instance of the MonthViewAreaElement class with the specified scheduler control, view configuration, and parent month view element.
Declaration
public MonthViewAreaElement(RadScheduler scheduler, SchedulerView view, SchedulerMonthViewElement monthViewElement)Parameters
scheduler
The RadScheduler control that owns this area element.
view
The SchedulerView configuration that this area belongs to.
monthViewElement
The parent SchedulerMonthViewElement that contains this area.
Fields
AppointmentHeightProperty
Identifies the AppointmentHeight dependency property.
Declaration
public static RadProperty AppointmentHeightPropertyField Value
CellOverflowArrowHeightProperty
Identifies the CellOverflowArrowHeight dependency property.
Declaration
public static RadProperty CellOverflowArrowHeightPropertyField Value
Properties
AppointmentHeight
Gets or sets the default height in pixels for appointment elements displayed within individual month view cells.
AppointmentsComparer
Gets or sets the comparer used to determine the display order and sorting of appointment elements within month view cells.
Declaration
public IComparer<AppointmentElement> AppointmentsComparer { get; set; }Property Value
IComparer<AppointmentElement>
CellOverflowArrowHeight
Gets or sets the height in pixels of the overflow arrow indicator that appears in month cells when there are more appointments than can be displayed in the available cell space, allowing users to access hidden appointments.
CellScrollBars
Gets the collection of vertical scroll bars that appear for individual month cells when they contain more appointments than can be displayed within the available cell space, enabling users to scroll through hidden appointments.
Declaration
public RadScrollBarElement[] CellScrollBars { get; protected set; }Property Value
Feedback
Gets the drag feedback element that provides visual feedback during appointment drag-and-drop operations within this month view area, or null if no drag operation is currently active or in progress.
Declaration
public DragFeedbackElement Feedback { get; }Property Value
Methods
ArrangeOverride(SizeF)
Arranges and positions all child elements including month cells, appointments, and scrollbars within the specified final size, handling overlap resolution and overflow states.
CreateAppointmentElements()
Creates appointment elements for all visible appointments in the month view, arranging them within their corresponding date cells.
Declaration
protected override IEnumerable<AppointmentElement> CreateAppointmentElements()Returns
IEnumerable<AppointmentElement>
A collection of AppointmentElement instances representing visible appointments.
Overrides
CreateCellElements()
Creates and initializes all cell elements for the month view grid, including day cells with appropriate dates and headers.
Declaration
protected override IEnumerable<SchedulerCellElement> CreateCellElements()Returns
IEnumerable<SchedulerCellElement>
An enumerable collection of SchedulerCellElement objects representing the month view cells.
Overrides
GetCellForDate(DateTime)
Gets the SchedulerCellElement that contains the specified date within the month view grid.
Declaration
public SchedulerCellElement GetCellForDate(DateTime date)Parameters
date
The date to search for within the month view cells.
Returns
The SchedulerCellElement that contains the specified date, or null if no matching cell is found.
GetContentCell(int, int)
Gets the MonthCellElement at the specified grid position within the month view layout.
Declaration
public MonthCellElement GetContentCell(int row, int column)Parameters
row
The zero-based row index of the requested cell.
column
The zero-based column index of the requested cell.
Returns
The MonthCellElement at the specified position, or null if no cell exists at that location.
GetDayNumberAsTextFromCalendar(DateTime)
Gets the day number as text from the calendar for the specified date, removing leading zeros for single-digit days.
GetFeedbackElementArrangeRectangle(SizeF)
Calculates and returns the arrange rectangle for the drag feedback element based on the current drag operation state.
Declaration
protected virtual RectangleF GetFeedbackElementArrangeRectangle(SizeF finalSize)Parameters
finalSize
The final arrange size of the month view area.
Returns
The calculated arrange rectangle for the feedback element, or Empty if no feedback is active.
InitializeAppointments()
Initializes all appointment elements for the month view and refreshes the cell scrollbars to accommodate appointment overflow display.
Declaration
public override void InitializeAppointments()Overrides
InitializeFields()
Initializes the default field values and sets the CSS class for the month view area element.
Declaration
protected override void InitializeFields()Overrides
MeasureOverride(SizeF)
Measures the size required by this element and its child elements, including month cells and appointments, based on the available size.
OnCellScrollBarValueChanged(object, EventArgs)
Handles the ValueChanged event when one of the cell scrollbars is scrolled, triggering layout updates to show different appointments.
Declaration
protected virtual void OnCellScrollBarValueChanged(object sender, EventArgs e)Parameters
sender
The RadScrollBarElement that raised the event.
e
The event arguments.
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property changes and triggers appropriate updates when properties affecting layout or appearance are modified.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)Parameters
e
The RadPropertyChangedEventArgs containing information about the changed property.
Overrides
RefreshCellScrollBars()
Updates and refreshes the scrollbars that appear in the last cell of each row when that row contains more appointments than can be displayed within the available cell space.
Declaration
protected virtual void RefreshCellScrollBars()UpdateCellsCore()
Updates the existing cell elements with current date information, headers, and selection states based on the current view configuration.
Declaration
protected override void UpdateCellsCore()Overrides