ClassSchedulerCellContainer
A base class for all visual elements in RadScheduler that can contain cells or appointments (for example DayViewAppointmentsTable, MonthViewAreaElement, TimelineAppointmentsPresenter, etc.)
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.Scheduler.dll
Syntax:
public abstract class SchedulerCellContainer : SchedulerVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementSchedulerVisualElementSchedulerCellContainer
Derived Classes:
Implements:
Inherited Members
Constructors
SchedulerCellContainer(RadScheduler, SchedulerView)
Declaration
public SchedulerCellContainer(RadScheduler scheduler, SchedulerView view)
Parameters
scheduler
view
Properties
AppointmentElements
Gets the AppointmentElement elements that belong to this container.
Declaration
public List<AppointmentElement> AppointmentElements { get; }
Property Value
List<AppointmentElement>
CellElements
Gets the SchedulerCellElement elements that belong to this container.
Declaration
public List<SchedulerCellElement> CellElements { get; }
Property Value
List<SchedulerCellElement>
Methods
CreateAppointmentElements()
Creates AppointmentElement elements which will be used in this container.
Declaration
protected abstract IEnumerable<AppointmentElement> CreateAppointmentElements()
Returns
IEnumerable<AppointmentElement>
A collection of the newly created appointment elements.
CreateCellElements()
Creates SchedulerCellElement elements which will be used in this container.
Declaration
protected abstract IEnumerable<SchedulerCellElement> CreateCellElements()
Returns
IEnumerable<SchedulerCellElement>
A collection of the newly created cells.
GetAppointmentElement(IEvent)
Gets the visual AppointmentElement associated with a specified appointment from this container.
Declaration
public AppointmentElement GetAppointmentElement(IEvent appointment)
Parameters
appointment
The specified appointment.
Returns
The visual element or null if no such element is found.
GetCellByDate(DateTime)
Gets the cell which represents a specified date.
Declaration
public SchedulerCellElement GetCellByDate(DateTime date)
Parameters
date
The specified date.
Returns
The corresponding cell.
InitializeAppointments()
Recycles the existing appointment elements in this container and replaces them with new ones.
Declaration
public virtual void InitializeAppointments()
InitializeCells()
Recycles the existing cell elements in this container and replaces them with new ones.
Declaration
public virtual void InitializeCells()
InitializeChildren()
Recycles the existing cell and appointment elements in this container and replaces them with new ones.
Declaration
public void InitializeChildren()
OnAppointmentLayout(AppointmentElement, RectangleF, SizeF)
Called when an appointment element is being arranged. Override to correct the arrange position of the appointment.
Declaration
protected virtual RectangleF OnAppointmentLayout(AppointmentElement appointment, RectangleF proposedRect, SizeF finalSize)
Parameters
appointment
The appointment element that is being arranged.
proposedRect
The calculated arrange rectangle.
finalSize
The arrange size of the parent container.
Returns
The corrected arrange bounds.
OnAppointmentsRefreshed()
Fires the AppointmentsRefreshed event.
Declaration
protected virtual void OnAppointmentsRefreshed()
OnAppointmentsRefreshing(CancelEventArgs)
Fires the AppointmentsRefreshing event.
Declaration
protected virtual void OnAppointmentsRefreshing(CancelEventArgs args)
Parameters
args
The event arguments for the event.
OnBeginDispose()
A callback used by the owning RadControl to notify the element for the beginning of a disposing process.
Declaration
protected override void OnBeginDispose()
Overrides
OnCellLayout(SchedulerCellElement, RectangleF, SizeF)
Called when a cell element is being arranged. Override to correct the arrange position of the cell.
Declaration
protected virtual RectangleF OnCellLayout(SchedulerCellElement cell, RectangleF proposedRect, SizeF finalSize)
Parameters
cell
The cell element that is being arranged.
proposedRect
The calculated arrange rectangle.
finalSize
The arrange size of the parent container.
Returns
The corrected arrange bounds.
OnCellsRefreshed()
Fires the CellsRefreshed event.
Declaration
protected virtual void OnCellsRefreshed()
OnCellsRefreshing(CancelEventArgs)
Fires the CellsRefreshing event.
Declaration
protected virtual void OnCellsRefreshing(CancelEventArgs args)
Parameters
args
The event arguments for the event.
RecycleAppointments()
Removes the existing appointment elements from the Children collection of the current container and tries to cache them for reusing in the future. If the caching is not successfull, the appointment element is disposed.
Declaration
protected virtual void RecycleAppointments()
RecycleCells()
Removes the existing cell elements from the Children collection of the current container and tries to cache them for reusing in the future. If the caching is not successfull, the cell is disposed.
Declaration
protected virtual void RecycleCells()
UpdateAppointments()
Synchronizes all appointment elements in this container with their associated IEvent.
Declaration
public virtual void UpdateAppointments()
UpdateCells()
Updates the existing cell elements according to the current settings of the associated view.
Declaration
public void UpdateCells()
UpdateCellsCore()
Overrideable method called by UpdateCells().
Declaration
protected abstract void UpdateCellsCore()
Events
AppointmentsRefreshed
Fired after the appointment elements in this container have been refreshed.
Declaration
public event EventHandler AppointmentsRefreshed
Event Value
AppointmentsRefreshing
Fired when the appointment elements in this container are about to be refreshed. Cancelable.
Declaration
public event CancelEventHandler AppointmentsRefreshing
Event Value
CellsRefreshed
Fired when the cell element in this container have been refreshed.
CellsRefreshing
Fired when the cell elements in this container are about to be refreshed. Cancelable.
Declaration
public event CancelEventHandler CellsRefreshing
Event Value