Class
SchedulerView

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.Scheduler.dll

Syntax:

cs-api-definition
public abstract class SchedulerView : INotifyPropertyChanged

Inheritance: objectSchedulerView

Derived Classes: SchedulerAgendaViewSchedulerDayViewBaseSchedulerMonthViewSchedulerTimelineView

Implements: INotifyPropertyChanged

Constructors

SchedulerView()

Declaration

cs-api-definition
public SchedulerView()

Fields

nullableStartDate

Declaration

cs-api-definition
protected DateTime? nullableStartDate

Field Value

DateTime?

Properties

AllowAppointmentMove

Enables or disables appointment moving

Declaration

cs-api-definition
public virtual bool AllowAppointmentMove { get; set; }

Property Value

bool

AllowAppointmentResize

Enables or disables appointment resizing

Declaration

cs-api-definition
public virtual bool AllowAppointmentResize { get; set; }

Property Value

bool

AllowResourcesScrolling

Gets or sets whether the horizontal scrollbar when the scheduler is grouped by resources is shown.

Declaration

cs-api-definition
public bool AllowResourcesScrolling { get; set; }

Property Value

bool

AllowToolTips

Gets or sets whether tool tips are displayed for this speciffic control.

Declaration

cs-api-definition
public virtual bool AllowToolTips { get; set; }

Property Value

bool

AppointmentTitleFormat

Gets or sets the appointment title format.

Declaration

cs-api-definition
public string AppointmentTitleFormat { get; set; }

Property Value

string

The appointment title format.

Appointments

Gets the appointments for that view.

Declaration

cs-api-definition
public SchedulerObservableCollection Appointments { get; }

Property Value

SchedulerObservableCollection

The appointments for that view.

CellToolTipFormat

Gets or sets the format string that is applied to the days cells tooltip.

Declaration

cs-api-definition
public string CellToolTipFormat { get; set; }

Property Value

string

Remarks

The property should contain either a format specifier character or a custom format pattern. For more information, see the summary page for System.Globalization.DateTimeFormatInfo.

By default this property uses formatting string of 'dddd, MMMM dd, yyyy'. Valid formats are all supported by the .NET Framework.

Example:

  • "d" is the standard short date pattern.
  • "%d" returns the day of the month; "%d" is a custom pattern.
  • "d " returns the day of the month followed by a white-space character; "d " is a custom pattern.

CurrentDate

Gets or sets a DateTime value specifying the starting date for the period handled by a SchedulerView instance.

Declaration

cs-api-definition
protected virtual DateTime? CurrentDate { get; set; }

Property Value

DateTime?

DefaultTimeZone

Gets or sets the offset time span.

Declaration

cs-api-definition
[Browsable(false)]
public virtual SchedulerTimeZone DefaultTimeZone { get; set; }

Property Value

SchedulerTimeZone

The offset time span.

EndDate

Declaration

cs-api-definition
public virtual DateTime EndDate { get; }

Property Value

DateTime

GroupSeparatorWidth

Gets or sets the separator width between different groups

Declaration

cs-api-definition
public int GroupSeparatorWidth { get; set; }

Property Value

int

Name

Gets or sets the name of the view.

Declaration

cs-api-definition
public virtual string Name { get; set; }

Property Value

string

OffsetTimeSpan

Gets or sets the offset time span.

Declaration

cs-api-definition
[Browsable(false)]
public virtual TimeSpan OffsetTimeSpan { get; set; }

Property Value

TimeSpan

The offset time span.

ReadOnly

Gets or sets a value indicating whether the view is in read-only mode.

Declaration

cs-api-definition
public virtual bool ReadOnly { get; set; }

Property Value

bool

ResourcesPerView

Gets or sets the resources shown in the current view.

Declaration

cs-api-definition
public int ResourcesPerView { get; set; }

Property Value

int

Scheduler

Gets the parent RadScheduler that the current view is assigned to.

Declaration

cs-api-definition
[Browsable(false)]
public RadScheduler Scheduler { get; }

Property Value

RadScheduler

ShowHeader

Gets or sets whether a single SchedulerView object will display a header row.

Declaration

cs-api-definition
public virtual bool ShowHeader { get; set; }

Property Value

bool

StartDate

Gets or sets a DateTime value specifying the starting date for the period handled by a SchedulerView instance.

Declaration

cs-api-definition
public virtual DateTime StartDate { get; set; }

Property Value

DateTime

ViewType

Declaration

cs-api-definition
public abstract SchedulerViewType ViewType { get; }

Property Value

SchedulerViewType

Visible

Gets or sets a value indicating whether the view is visible or partially visible.

Declaration

cs-api-definition
[Browsable(false)]
public bool Visible { get; set; }

Property Value

bool

Methods

AddAppointment(IEvent)

Adds the appointment.

Declaration

cs-api-definition
protected virtual void AddAppointment(IEvent appointment)

Parameters

appointment

IEvent

The appointment.

AddResources(SchedulerResourceCollection)

Declaration

cs-api-definition
protected virtual void AddResources(SchedulerResourceCollection resources)

Parameters

resources

SchedulerResourceCollection

AppointmentChanged(IEvent, string)

Declaration

cs-api-definition
protected virtual void AppointmentChanged(IEvent appointment, string propertyName)

Parameters

appointment

IEvent

propertyName

string

CalculateNextDate(IEnumerable<IEvent>, ref DateTime)

Declaration

cs-api-definition
protected DateTime CalculateNextDate(IEnumerable<IEvent> appointments, ref DateTime endDate)

Parameters

appointments

IEnumerable<IEvent>

endDate

DateTime

Returns

DateTime

CalculatePreviousView(IEnumerable<IEvent>, DateTime)

Declaration

cs-api-definition
protected virtual SchedulerView CalculatePreviousView(IEnumerable<IEvent> appointments, DateTime startDate)

Parameters

appointments

IEnumerable<IEvent>

startDate

DateTime

Returns

SchedulerView

CopyPropertiesToView(SchedulerView)

Declaration

cs-api-definition
protected virtual void CopyPropertiesToView(SchedulerView other)

Parameters

other

SchedulerView

CreateView(SchedulerViewType)

Creates a SchedulerView given the desired type.

Declaration

cs-api-definition
public static SchedulerView CreateView(SchedulerViewType value)

Parameters

value

SchedulerViewType

The view type.

Returns

SchedulerView

CreateViewWithStartDate(DateTime)

Declaration

cs-api-definition
protected abstract SchedulerView CreateViewWithStartDate(DateTime startDate)

Parameters

startDate

DateTime

Returns

SchedulerView

GetEndDate(DateTime)

Gets the end date for that SchedulerView given a start date.

Declaration

cs-api-definition
protected abstract DateTime GetEndDate(DateTime startDate)

Parameters

startDate

DateTime

The start date.

Returns

DateTime

GetFirstAppointment()

Gets the first appointment in this view, if any.

Declaration

cs-api-definition
public IEvent GetFirstAppointment()

Returns

IEvent

The first appointment in this view, or null of there are no appointments.

GetLastAppointment()

Gets the last appointment in this view, if any.

Declaration

cs-api-definition
public IEvent GetLastAppointment()

Returns

IEvent

The last appointment in this view, or null of there are no appointments.

GetNextView()

Gets the next view.

Declaration

cs-api-definition
public SchedulerView GetNextView()

Returns

SchedulerView

GetNextView(NavigationStepTypes, int)

Gets the next view.

Declaration

cs-api-definition
public abstract SchedulerView GetNextView(NavigationStepTypes navigationStepType, int navigationStep)

Parameters

navigationStepType

NavigationStepTypes

The navigation step type.

navigationStep

int

The navigation step.

Returns

SchedulerView

GetNextView(int)

Gets the next view.

Declaration

cs-api-definition
public abstract SchedulerView GetNextView(int offset)

Parameters

offset

int

The offset.

Returns

SchedulerView

GetNextViewWithAppointments(IEnumerable<IEvent>)

Gets the next view containing any of the given appointments.

Declaration

cs-api-definition
public virtual SchedulerView GetNextViewWithAppointments(IEnumerable<IEvent> appointments)

Parameters

appointments

IEnumerable<IEvent>

Returns

SchedulerView

GetPreviousView()

Gets the previous view.

Declaration

cs-api-definition
public SchedulerView GetPreviousView()

Returns

SchedulerView

GetPreviousView(NavigationStepTypes, int)

Gets the previous view.

Declaration

cs-api-definition
public abstract SchedulerView GetPreviousView(NavigationStepTypes navigationStepType, int navigationStep)

Parameters

navigationStepType

NavigationStepTypes

The navigation step type.

navigationStep

int

The navigation step.

Returns

SchedulerView

GetPreviousView(int)

Gets the previous view.

Declaration

cs-api-definition
public abstract SchedulerView GetPreviousView(int offset)

Parameters

offset

int

The offset.

Returns

SchedulerView

GetPreviousViewWithAppointments(IEnumerable<IEvent>)

Gets the previous view containing any of the given appointments.

Declaration

cs-api-definition
public virtual SchedulerView GetPreviousViewWithAppointments(IEnumerable<IEvent> appointments)

Parameters

appointments

IEnumerable<IEvent>

Returns

SchedulerView

GetResource()

Declaration

cs-api-definition
public virtual IResource GetResource()

Returns

IResource

GetResourceId()

Declaration

cs-api-definition
public virtual EventId GetResourceId()

Returns

EventId

GetResources()

Declaration

cs-api-definition
public virtual SchedulerResourceCollection GetResources()

Returns

SchedulerResourceCollection

GetViewContainingDate(DateTime)

Gets the view containing date.

Declaration

cs-api-definition
public abstract SchedulerView GetViewContainingDate(DateTime date)

Parameters

date

DateTime

The date.

Returns

SchedulerView

GetViewContainingDate(DateTime, int)

Declaration

cs-api-definition
protected virtual SchedulerView GetViewContainingDate(DateTime date, int viewDayCount)

Parameters

date

DateTime

viewDayCount

int

Returns

SchedulerView

IsAllDayEvent(IEvent)

Determines whether the specified event is all day

Declaration

cs-api-definition
public virtual bool IsAllDayEvent(IEvent appointment)

Parameters

appointment

IEvent

The event

Returns

bool

true if the specified event is all day; otherwise, false.

IsAppointmentInView(IEvent)

Determines whether a given appointment intersects with this view..

Declaration

cs-api-definition
public virtual bool IsAppointmentInView(IEvent appointment)

Parameters

appointment

IEvent

The appointment.

Returns

bool

true if a given appointment intersects with this view; otherwise, false.

IsDateInView(DateTime)

Determines if a DateTime object belongs to the dates range managed by a particular SchedulerView.

Declaration

cs-api-definition
public virtual bool IsDateInView(DateTime date)

Parameters

date

DateTime

The DateTime object to be tested.

Returns

bool

True if the DateTime object belongs to the dates range managed by a particular SchedulerView; False otherwise.

IsResourceIntersectsWithViewResources(IEvent)

Declaration

cs-api-definition
protected virtual bool IsResourceIntersectsWithViewResources(IEvent appointment)

Parameters

appointment

IEvent

Returns

bool

IsViewInAccessibleInterval(DateTime)

Declaration

cs-api-definition
protected virtual bool IsViewInAccessibleInterval(DateTime startDate)

Parameters

startDate

DateTime

Returns

bool

OffsetView(int)

Offsets the view.

Declaration

cs-api-definition
public virtual SchedulerView OffsetView(int offset)

Parameters

offset

int

The offset.

Returns

SchedulerView

OnPropertyChanged(params string[])

Declaration

cs-api-definition
protected virtual void OnPropertyChanged(params string[] propertyNames)

Parameters

propertyNames

string[]

RemoveAppointment(IEvent)

Declaration

cs-api-definition
protected virtual void RemoveAppointment(IEvent appointment)

Parameters

appointment

IEvent

SetDefaultTimeZone(SchedulerTimeZone)

Declaration

cs-api-definition
protected virtual void SetDefaultTimeZone(SchedulerTimeZone defaultTimeZone)

Parameters

defaultTimeZone

SchedulerTimeZone

SetStartDate(DateTime)

Declaration

cs-api-definition
protected virtual bool SetStartDate(DateTime value)

Parameters

value

DateTime

Returns

bool

UpdateAppointments(ObservableCollection<IEvent>)

Updates the appointments for that view.

Declaration

cs-api-definition
public virtual void UpdateAppointments(ObservableCollection<IEvent> appointments)

Parameters

appointments

ObservableCollection<IEvent>

The appointments for that view.

UpdateOnPropertyChange(string)

Declaration

cs-api-definition
protected virtual void UpdateOnPropertyChange(string propertyName)

Parameters

propertyName

string

Events

PropertyChanged

Declaration

cs-api-definition
public event PropertyChangedEventHandler PropertyChanged

Event Value

PropertyChangedEventHandler

Implements INotifyPropertyChanged.PropertyChanged