MonthViewAreaElement
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
Initializes a new instance of the MonthViewAreaElement class with the specified scheduler control, view configuration, and parent month view element.
public MonthViewAreaElement(RadScheduler scheduler, SchedulerView view, SchedulerMonthViewElement monthViewElement)The RadScheduler control that owns this area element.
viewSchedulerViewThe SchedulerView configuration that this area belongs to.
monthViewElementSchedulerMonthViewElementThe parent SchedulerMonthViewElement that contains this area.
Fields
Identifies the AppointmentHeight dependency property.
public static RadProperty AppointmentHeightPropertyIdentifies the CellOverflowArrowHeight dependency property.
public static RadProperty CellOverflowArrowHeightPropertyProperties
Gets or sets the default height in pixels for appointment elements displayed within individual month view cells.
public int AppointmentHeight { get; set; }AppointmentsComparer
IComparer<AppointmentElement>
Gets or sets the comparer used to determine the display order and sorting of appointment elements within month view cells.
public IComparer<AppointmentElement> AppointmentsComparer { get; set; }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.
public int CellOverflowArrowHeight { get; set; }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.
public RadScrollBarElement[] CellScrollBars { get; protected set; }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.
public DragFeedbackElement Feedback { get; }Methods
Arranges and positions all child elements including month cells, appointments, and scrollbars within the specified final size, handling overlap resolution and overflow states.
Creates appointment elements for all visible appointments in the month view, arranging them within their corresponding date cells.
protected override IEnumerable<AppointmentElement> CreateAppointmentElements()IEnumerable<AppointmentElement>
A collection of AppointmentElement instances representing visible appointments.
Overrides:
Creates and initializes all cell elements for the month view grid, including day cells with appropriate dates and headers.
protected override IEnumerable<SchedulerCellElement> CreateCellElements()IEnumerable<SchedulerCellElement>
An enumerable collection of SchedulerCellElement objects representing the month view cells.
Overrides:
Gets the SchedulerCellElement that contains the specified date within the month view grid.
public SchedulerCellElement GetCellForDate(DateTime 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.
Gets the MonthCellElement at the specified grid position within the month view layout.
public MonthCellElement GetContentCell(int row, int column)The zero-based row index of the requested cell.
columnintThe zero-based column index of the requested cell.
Returns:The MonthCellElement at the specified position, or null if no cell exists at that location.
Gets the day number as text from the calendar for the specified date, removing leading zeros for single-digit days.
Calculates and returns the arrange rectangle for the drag feedback element based on the current drag operation state.
Initializes all appointment elements for the month view and refreshes the cell scrollbars to accommodate appointment overflow display.
public override void InitializeAppointments()Overrides:
Initializes the default field values and sets the CSS class for the month view area element.
protected override void InitializeFields()Overrides:
Measures the size required by this element and its child elements, including month cells and appointments, based on the available size.
Handles the ValueChanged event when one of the cell scrollbars is scrolled, triggering layout updates to show different appointments.
protected virtual void OnCellScrollBarValueChanged(object sender, EventArgs e)The RadScrollBarElement that raised the event.
eEventArgsThe event arguments.
Handles property changes and triggers appropriate updates when properties affecting layout or appearance are modified.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The RadPropertyChangedEventArgs containing information about the changed property.
Overrides:
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.
protected virtual void RefreshCellScrollBars()Updates the existing cell elements with current date information, headers, and selection states based on the current view configuration.
protected override void UpdateCellsCore()Overrides: