RadScheduler
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.Scheduler.dll
Syntax:
[TelerikToolboxCategory("Scheduler")]
public class RadScheduler : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ICultureInfoProvider, ISchedulerData, IPrintable
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadScheduler...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadScheduler class.
public RadScheduler()
Fields
public static readonly CreateNewAppointmentCommand CreateNewAppointmentCommand
public const string ICalendarDataFormat = "ICal"
public static readonly NavigateBackwardCommand NavigateBackwardCommand
public static readonly NavigateForwardCommand NavigateForwardCommand
public static readonly NavigateToNextAppointmentsCommand NavigateToNextAppointmentsCommand
public static readonly NavigateToNextViewCommand NavigateToNextViewCommand
public static readonly NavigateToPreviousAppointmentsCommand NavigateToPreviousAppointmentsCommand
public static readonly NavigateToPreviousViewCommand NavigateToPreviousViewCommand
Properties
Gets or sets the interval which is accessible to the user.
[Browsable(true)]
public virtual DateTimeInterval AccessibleInterval { get; set; }
The accessible interval. Default value is DateTimeInterval.Empty.
Gets or sets the active view.
[Browsable(false)]
public virtual SchedulerView ActiveView { get; set; }
The active view.
Gets or sets the type of the active view.
public virtual SchedulerViewType ActiveViewType { get; set; }
The type of the active view.
Enables or disables creating appointments when typing in a cell.
public virtual bool AllowAppointmentCreateInline { get; set; }
Enables or disables appointment moving.
public virtual bool AllowAppointmentMove { get; set; }
Enables or disables appointment resizing
public virtual bool AllowAppointmentResize { get; set; }
Gets or sets a value indicating whether selecting multiple appointments is possible.
public bool AllowAppointmentsMultiSelect { get; set; }
Allows or disallows the end user to copy, cut and paste appointments using the default combinations Ctrl+X, Ctrl+C and Ctrl+V.
public CopyPasteMode AllowCopyPaste { get; set; }
Enables or disables mouse wheel support.
public virtual bool AllowMouseWheelSupport { get; set; }
Gets or sets a value indicating whether tool tips are shown.
public bool AllowToolTips { get; set; }
true if tool tips are shown; otherwise, false.
Enables automatic navigation to previous/next view when dragging an appointment outside the boundaries of the control.
public bool AllowViewNavigationOnDrag { get; set; }
Gets or sets a factory class that is used when creating appointment elements.
[Browsable(false)]
public IAppointmentElementFactory AppointmentElementFactory { get; set; }
Gets or sets the appointment exception of recurrence icon.
[Browsable(false)]
public Image AppointmentExceptionOfRecurrenceIcon { get; set; }
The appointment exception of recurrence icon.
Gets or sets an IAppointmentFactory which used to create IEvent objects which represent the appointments in RadScheduler.
[Browsable(false)]
public IAppointmentFactory AppointmentFactory { get; set; }
Gets or sets the appointment recurrence icon.
[Browsable(false)]
public Image AppointmentRecurrenceIcon { get; set; }
The appointment recurrence icon.
Gets the appointments.
[Browsable(false)]
public virtual SchedulerAppointmentCollection Appointments { get; }
The appointments.
AppointmentsComparer
IComparer<AppointmentElement>
Gets or sets a comparer which will be used to determine the order of the appointments when they have the same Start and End dates.
[Browsable(false)]
public IComparer<AppointmentElement> AppointmentsComparer { get; set; }
Gets or sets the appointment title format.
public string AppointmentTitleFormat { get; set; }
The appointment title format.
Gets or sets a value indicating whether the appointments elements should be sized to fit their content.
public bool AutoSizeAppointments { get; set; }
Gets the backgrounds.
[Browsable(false)]
public virtual SchedulerBackgroundCollection Backgrounds { get; }
The backgrounds.
Gets or sets the CultureInfo supported by this RadScheduler object.
Describes the names of the culture, the writing system, and the calendar used, as well as access to culture-specific objects that provide methods for common operations, such as formatting dates and sorting strings.
[TypeConverter(typeof(CultureInfoConverter))]
public CultureInfo Culture { get; set; }
Implements:
The culture names follow the RFC 1766 standard in the format "<languagecode2>-<country/regioncode2>", where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, U.S. English is "en-US". In cases where a two-letter language code is not available, the three-letter code derived from ISO 639-2 is used; for example, the three-letter code "div" is used for cultures that use the Dhivehi language. Some culture names have suffixes that specify the script; for example, "-Cyrl" specifies the Cyrillic script, "-Latn" specifies the Latin script.
The following predefined CultureInfo names and identifiers are accepted and used by this class and other classes in the System.Globalization namespace.
Culture Name Culture Identifier Language-Country/Region "" (empty string) 0x007F invariant culture af 0x0036 Afrikaans af-ZA 0x0436 Afrikaans - South Africa sq 0x001C Albanian sq-AL 0x041C Albanian - Albania ar 0x0001 Arabic ar-DZ 0x1401 Arabic - Algeria ar-BH 0x3C01 Arabic - Bahrain ar-EG 0x0C01 Arabic - Egypt ar-IQ 0x0801 Arabic - Iraq ar-JO 0x2C01 Arabic - Jordan ar-KW 0x3401 Arabic - Kuwait ar-LB 0x3001 Arabic - Lebanon ar-LY 0x1001 Arabic - Libya ar-MA 0x1801 Arabic - Morocco ar-OM 0x2001 Arabic - Oman ar-QA 0x4001 Arabic - Qatar ar-SA 0x0401 Arabic - Saudi Arabia ar-SY 0x2801 Arabic - Syria ar-TN 0x1C01 Arabic - Tunisia ar-AE 0x3801 Arabic - United Arab Emirates ar-YE 0x2401 Arabic - Yemen hy 0x002B Armenian hy-AM 0x042B Armenian - Armenia az 0x002C Azeri az-AZ-Cyrl 0x082C Azeri (Cyrillic) - Azerbaijan az-AZ-Latn 0x042C Azeri (Latin) - Azerbaijan eu 0x002D Basque eu-ES 0x042D Basque - Basque be 0x0023 Belarusian be-BY 0x0423 Belarusian - Belarus bg 0x0002 Bulgarian bg-BG 0x0402 Bulgarian - Bulgaria ca 0x0003 Catalan ca-ES 0x0403 Catalan - Catalan zh-HK 0x0C04 Chinese - Hong Kong SAR zh-MO 0x1404 Chinese - Macau SAR zh-CN 0x0804 Chinese - China zh-CHS 0x0004 Chinese (Simplified) zh-SG 0x1004 Chinese - Singapore zh-TW 0x0404 Chinese - Taiwan zh-CHT 0x7C04 Chinese (Traditional) hr 0x001A Croatian hr-HR 0x041A Croatian - Croatia cs 0x0005 Czech cs-CZ 0x0405 Czech - Czech Republic da 0x0006 Danish da-DK 0x0406 Danish - Denmark div 0x0065 Dhivehi div-MV 0x0465 Dhivehi - Maldives nl 0x0013 Dutch nl-BE 0x0813 Dutch - Belgium nl-NL 0x0413 Dutch - The Netherlands en 0x0009 English en-AU 0x0C09 English - Australia en-BZ 0x2809 English - Belize en-CA 0x1009 English - Canada en-CB 0x2409 English - Caribbean en-IE 0x1809 English - Ireland en-JM 0x2009 English - Jamaica en-NZ 0x1409 English - New Zealand en-PH 0x3409 English - Philippines en-ZA 0x1C09 English - South Africa en-TT 0x2C09 English - Trinidad and Tobago en-GB 0x0809 English - United Kingdom en-US 0x0409 English - United States en-ZW 0x3009 English - Zimbabwe et 0x0025 Estonian et-EE 0x0425 Estonian - Estonia fo 0x0038 Faroese fo-FO 0x0438 Faroese - Faroe Islands fa 0x0029 Farsi fa-IR 0x0429 Farsi - Iran fi 0x000B Finnish fi-FI 0x040B Finnish - Finland fr 0x000C French fr-BE 0x080C French - Belgium fr-CA 0x0C0C French - Canada fr-FR 0x040C French - France fr-LU 0x140C French - Luxembourg fr-MC 0x180C French - Monaco fr-CH 0x100C French - Switzerland gl 0x0056 Galician gl-ES 0x0456 Galician - Galician ka 0x0037 Georgian ka-GE 0x0437 Georgian - Georgia de 0x0007 German de-AT 0x0C07 German - Austria de-DE 0x0407 German - Germany de-LI 0x1407 German - Liechtenstein de-LU 0x1007 German - Luxembourg de-CH 0x0807 German - Switzerland el 0x0008 Greek el-GR 0x0408 Greek - Greece gu 0x0047 Gujarati gu-IN 0x0447 Gujarati - India he 0x000D Hebrew he-IL 0x040D Hebrew - Israel hi 0x0039 Hindi hi-IN 0x0439 Hindi - India hu 0x000E Hungarian hu-HU 0x040E Hungarian - Hungary is 0x000F Icelandic is-IS 0x040F Icelandic - Iceland id 0x0021 Indonesian id-ID 0x0421 Indonesian - Indonesia it 0x0010 Italian it-IT 0x0410 Italian - Italy it-CH 0x0810 Italian - Switzerland ja 0x0011 Japanese ja-JP 0x0411 Japanese - Japan kn 0x004B Kannada kn-IN 0x044B Kannada - India kk 0x003F Kazakh kk-KZ 0x043F Kazakh - Kazakhstan kok 0x0057 Konkani kok-IN 0x0457 Konkani - India ko 0x0012 Korean ko-KR 0x0412 Korean - Korea ky 0x0040 Kyrgyz ky-KZ 0x0440 Kyrgyz - Kazakhstan lv 0x0026 Latvian lv-LV 0x0426 Latvian - Latvia lt 0x0027 Lithuanian lt-LT 0x0427 Lithuanian - Lithuania mk 0x002F Macedonian mk-MK 0x042F Macedonian - FYROM ms 0x003E Malay ms-BN 0x083E Malay - Brunei ms-MY 0x043E Malay - Malaysia mr 0x004E Marathi mr-IN 0x044E Marathi - India mn 0x0050 Mongolian mn-MN 0x0450 Mongolian - Mongolia no 0x0014 Norwegian nb-NO 0x0414 Norwegian (Bokmål) - Norway nn-NO 0x0814 Norwegian (Nynorsk) - Norway pl 0x0015 Polish pl-PL 0x0415 Polish - Poland pt 0x0016 Portuguese pt-BR 0x0416 Portuguese - Brazil pt-PT 0x0816 Portuguese - Portugal pa 0x0046 Punjabi pa-IN 0x0446 Punjabi - India ro 0x0018 Romanian ro-RO 0x0418 Romanian - Romania ru 0x0019 Russian ru-RU 0x0419 Russian - Russia sa 0x004F Sanskrit sa-IN 0x044F Sanskrit - India sr-SP-Cyrl 0x0C1A Serbian (Cyrillic) - Serbia sr-SP-Latn 0x081A Serbian (Latin) - Serbia sk 0x001B Slovak sk-SK 0x041B Slovak - Slovakia sl 0x0024 Slovenian sl-SI 0x0424 Slovenian - Slovenia es 0x000A Spanish es-AR 0x2C0A Spanish - Argentina es-BO 0x400A Spanish - Bolivia es-CL 0x340A Spanish - Chile es-CO 0x240A Spanish - Colombia es-CR 0x140A Spanish - Costa Rica es-DO 0x1C0A Spanish - Dominican Republic es-EC 0x300A Spanish - Ecuador es-SV 0x440A Spanish - El Salvador es-GT 0x100A Spanish - Guatemala es-HN 0x480A Spanish - Honduras es-MX 0x080A Spanish - Mexico es-NI 0x4C0A Spanish - Nicaragua es-PA 0x180A Spanish - Panama es-PY 0x3C0A Spanish - Paraguay es-PE 0x280A Spanish - Peru es-PR 0x500A Spanish - Puerto Rico es-ES 0x0C0A Spanish - Spain es-UY 0x380A Spanish - Uruguay es-VE 0x200A Spanish - Venezuela sw 0x0041 Swahili sw-KE 0x0441 Swahili - Kenya sv 0x001D Swedish sv-FI 0x081D Swedish - Finland sv-SE 0x041D Swedish - Sweden syr 0x005A Syriac syr-SY 0x045A Syriac - Syria ta 0x0049 Tamil ta-IN 0x0449 Tamil - India tt 0x0044 Tatar tt-RU 0x0444 Tatar - Russia te 0x004A Telugu te-IN 0x044A Telugu - India th 0x001E Thai th-TH 0x041E Thai - Thailand tr 0x001F Turkish tr-TR 0x041F Turkish - Turkey uk 0x0022 Ukrainian uk-UA 0x0422 Ukrainian - Ukraine ur 0x0020 Urdu ur-PK 0x0420 Urdu - Pakistan uz 0x0043 Uzbek uz-UZ-Cyrl 0x0843 Uzbek (Cyrillic) - Uzbekistan uz-UZ-Latn 0x0443 Uzbek (Latin) - Uzbekistan vi 0x002A Vietnamese vi-VN 0x042A Vietnamese - Vietnam
Gets or sets the data source.
public virtual SchedulerDataSource DataSource { get; set; }
The data source.
Gets or sets a DateTimeFormatInfo instance that defines the culturally appropriate format of displaying dates and times as specified by the default culture.
[Browsable(false)]
public DateTimeFormatInfo DateTimeFormat { get; }
A DateTimeFormatInfo can be created only for the invariant culture or for specific cultures, not for neutral cultures.
The cultures are generally grouped into three sets: the invariant culture, the neutral cultures, and the specific cultures.
The invariant culture is culture-insensitive. You can specify the invariant culture by name using an empty string ("") or by its culture identifier 0x007F. InvariantCulture retrieves an instance of the invariant culture. It is associated with the English language but not with any country/region. It can be used in almost any method in the Globalization namespace that requires a culture. If a security decision depends on a string comparison or a case-change operation, use the InvariantCulture to ensure that the behavior will be consistent regardless of the culture settings of the system. However, the invariant culture must be used only by processes that require culture-independent results, such as system services; otherwise, it produces results that might be linguistically incorrect or culturally inappropriate.
A neutral culture is a culture that is associated with a language but not with a country/region. A specific culture is a culture that is associated with a language and a country/region. For example, "fr" is a neutral culture and "fr-FR" is a specific culture. Note that "zh-CHS" (Simplified Chinese) and "zh-CHT" (Traditional Chinese) are neutral cultures.
The user might choose to override some of the values associated with the current culture of Windows through Regional and Language Options (or Regional Options or Regional Settings) in Control Panel. For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.
If UseUserOverride is true and the specified culture matches the current culture of Windows, the CultureInfo uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, the properties of the NumberFormatInfo instance returned by the NumberFormat property, and the properties of the CompareInfo instance returned by the CompareInfo property. If the user settings are incompatible with the culture associated with the CultureInfo (for example, if the selected calendar is not one of the OptionalCalendars ), the results of the methods and the values of the properties are undefined.
Note: In this version of RadCalendar the NumberFormatInfo instance returned by the NumberFormat property is not taken into account.
Gets the default size of the control.
protected override Size DefaultSize { get; }
Overrides:
Gets or sets which edge of the parent container a control is docked to.
public DockStyle Dock { get; set; }
Gets or sets the AppointmentDraggingBehavior which is responsible for performing the drag and drop of appointments in RadScheduler.
[Browsable(false)]
public AppointmentDraggingBehavior DragDropBehavior { get; }
Gets or sets the SchedulerElementProvider which is responsible for creating and recycling of most of RadScheduler's visual elements.
[Browsable(false)]
public SchedulerElementProvider ElementProvider { get; set; }
Gets or sets a value indicating whether the CellPaint event will be fired.
public bool EnableCustomCellDrawing { get; set; }
Gets or sets whether appointments are rendered according to their start and end time or are aligned to the scheduler grid lines.
public bool EnableExactTimeRendering { get; set; }
Gets or sets the value that is used by RadScheduler to determine the viewable area displayed .
public DateTime FocusedDate { get; set; }
By default, the FocusedDate property returns the current system date when in runtime, and in design mode defaults to System.DateTime.MinValue. When the FocusedDate is set, from that point, the value returned by the FocusedDate property is the one the user sets.
Gets or sets the type of grouping.
[Browsable(false)]
public GroupType GroupType { get; set; }
Implements:
Gets or sets the header format.
public string HeaderFormat { get; set; }
The header format.
Gets or sets value whether to show the today visual state of scheduler cells
public bool HighlightToday { get; set; }
Represents the collection with Holidays object
public SchedulerHolidays Holidays { get; set; }
Gets or sets the back color of the appointment when it has the default None category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentBackColor { get; set; }
Gets or sets the second back color of the appointment when it has a linear gradient in the default None category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentBackColor2 { get; set; }
Gets or sets the back color of the appointment when it has the Blue category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentBlueColor { get; set; }
Gets or sets the border color of the appointment when it has the default None category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentBorderColor { get; set; }
Gets or sets the fore color of the appointment. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentForeColor { get; set; }
Gets or sets the back color of the appointment when it has the Gray category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentGrayColor { get; set; }
Gets or sets the back color of the appointment when it has the Green category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentGreenColor { get; set; }
Gets or sets the back color of the appointment when it has the Lavender category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentLavenderColor { get; set; }
Gets or sets the back color of the appointment when it has the Olive category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentOliveColor { get; set; }
Gets or sets the back color of the appointment when it has the Orange category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentOrangeColor { get; set; }
Gets or sets the back color of the appointment when it has the Pink category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentPinkColor { get; set; }
Gets or sets the back color of the appointment when it has the Purple category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentPurpleColor { get; set; }
Gets or sets the back color of the appointment when it has the Raspberry category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentRaspberryColor { get; set; }
Gets or sets the back color of the appointment when it has the Yellow category. This color is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public Color ModernAppointmentYellowColor { get; set; }
Gets or sets the padding within the control.
[Browsable(false)]
public Padding Padding { get; set; }
Gets or sets whether the borders of the appointment element will be painted. This color is set via the ModernAppointmentBorderColor property and is applied only for appointments with modern styles. Check the UseModernAppointmentStyles property for more details.
public bool PaintModernApppointmentsBorders { get; set; }
Gets or sets the factory used to create print settings dialogs. If not explicitly set, it defaults to a new instance of SchedulerPrintSettingsDialogFactory.
[Browsable(false)]
public IPrintSettingsDialogFactory PrintSettingsDialogFactory { get; set; }
Gets or sets a value indicating how the RadScheduler is printed.
public SchedulerPrintStyle PrintStyle { get; set; }
Gets or sets the shortcut menu associated with the control.
public virtual RadContextMenu RadContextMenu { get; set; }
Gets or sets a value indicating whether appointments can be changed.
public virtual bool ReadOnly { get; set; }
true if the scheduler is read-only; otherwise, false.
Gets the predefined reminder time intervals.
[Browsable(false)]
public virtual SchedulerReminderCollection Reminders { get; }
The reminder intervals.
Gets or sets the AppointmentResizingBehavior which is responsible for performing the resizing of appointments in RadScheduler.
[Browsable(false)]
public AppointmentResizingBehavior ResizeBehavior { get; }
Gets the resources.
[Browsable(false)]
public virtual SchedulerResourceCollection Resources { get; }
The resources.
Gets or sets the behavior responsible for saving and loading appointment reminders. This behavior handles persistence of reminders between application sessions.
public SchedulerSaveLoadRemindersBehavior SaveLoadRemindersBehavior { get; set; }
Gets the scheduler element.
[Browsable(false)]
public RadSchedulerElement SchedulerElement { get; }
The scheduler element.
Gets or sets the SchedulerInputBehavior which is responsible for handling the mouse and keyboard input. Be sure to dispose the old instance when replacing it with a new one.
[Browsable(false)]
public SchedulerInputBehavior SchedulerInputBehavior { get; set; }
Gets or sets the SchedulerSelectionBehavior which is responsible for handling the selection of cells and appointments in RadScheduler.
[Browsable(false)]
public SchedulerSelectionBehavior SelectionBehavior { get; set; }
Gets or sets a value indicating whether to display all day appointment status.
public virtual bool ShowAllDayAppointmentStatus { get; set; }
true if all day appointment status is displayed; otherwise, false.
Gets or sets a value indicating whether the appointment status should be displayed.
public virtual bool ShowAppointmentStatus { get; set; }
true if appointment status is displayed otherwise, false.
Gets or sets a value whether to show the "Previous/Next Appointment" navigation elements.
public bool ShowNavigationElements { get; set; }
Gets the statuses.
[Browsable(false)]
public virtual SchedulerStatusCollection Statuses { get; }
The statuses.
Gets or sets the selected time zone.
[Browsable(false)]
public SchedulerTimeZone SystemTimeZone { get; set; }
The selected time zone.
Determines whether the appointments are painted with modern colors and borders. The default value is true.
public bool UseModernAppointmentStyles { get; set; }
Gets the view element.
[Browsable(false)]
public SchedulerViewElement ViewElement { get; }
The view element.
Methods
Shows the appointment edit dialog to add a new appointment.
public void AddNewAppointmentWithDialog(DateTimeInterval interval, bool allDay, bool recurringAppointment, SchedulerResourceCollection resources)
The interval to pass to the ShowAppointmentEditDialog method.
allDayboolIndicates whether the appointment should be an AllDay appointment.
recurringAppointmentboolIndicates whether the appointment should be a recurring one.
resourcesSchedulerResourceCollectionThe resources of the new appointment.
Shows the appointment edit dialog to add a new appointment.
public void AddNewAppointmentWithDialog(DateTimeInterval interval, bool recurringAppointment, SchedulerResourceCollection resources)
The interval to pass to the ShowAppointmentEditDialog method.
recurringAppointmentboolIndicates whether the appointment should be a recurring one.
resourcesSchedulerResourceCollectionThe resources of the new appointment.
public virtual void AddNewAppointmentWithDialog(IEvent appointment, DateTimeInterval interval, bool recurringAppointment, SchedulerResourceCollection resources)
Clears the reminders of all appointments. Usually this method is used before LoadReminders is called.
public void ClearReminders()
Determines whether this control defines the theme for the specified element.
public override bool ControlDefinesThemeForElement(RadElement element)
The element to check.
Returns:true if this control defines the theme for the element; otherwise, false.
Overrides:
Copies the currently selected appointments to the clipboard.
public void Copy()
Creates the accessibility instance for the RadScheduler control.
protected override AccessibleObject CreateAccessibilityInstance()
An AccessibleObject instance that provides accessibility information for the control.
Overrides:
Creates the appointment edit dialog. Overwrite in an inheriting class to replace the dialog used to edit appointments.
protected virtual IEditAppointmentDialog CreateAppointmentEditDialog()
IEditAppointmentDialog
protected virtual AppointmentBackgroundInfo CreateBackgroundInfo(AppointmentBackground category, string stringId, Color backColor, Color backColor2, Color foreColor, Color borderColor)
protected virtual AppointmentBackgroundInfo CreateBackgroundInfo(AppointmentBackground category, string stringId, Color backColor, Color backColor2)
Creates the child items for the RadScheduler control.
protected override void CreateChildItems(RadElement parent)
The parent element to which the child items will be added.
Overrides:
Creates the RadSchedulerElement for this scheduler.
protected virtual RadSchedulerElement CreateRadSchedulerElement()
A RadSchedulerElement instance that will be used as the main element for this scheduler.
Deletes the currently selected appointments and saves them to the clipboard.
public void Cut()
Binds the scheduler to its data source and populates appointments and resources collections.
public void DataBind()
Exports the data in this RadScheduler instance in a string, using the specified ISchedulerExporter instance.
public virtual string Export(ISchedulerExporter exporter)
Exports the data in this RadScheduler instance to the specified stream, using the specified ISchedulerExporter instance.
public virtual void Export(Stream stream, ISchedulerExporter exporter)
Fills the default backgrounds.
protected virtual void FillDefaultBackgrounds(SchedulerBackgroundCollection backgrounds)
The background collection in which to add the background objects.
Fills the default reminder intervals.
protected virtual void FillDefaultReminders(SchedulerReminderCollection reminders)
The reminder collection in which to add the reminder objects.
Fills the default statuses.
protected virtual void FillDefaultStatuses(SchedulerStatusCollection statuses)
The status collection in which to add the status objects.
Gets the agenda view.
Gets the background storage.
public virtual ISchedulerStorage<IAppointmentBackgroundInfo> GetBackgroundStorage()
Implements:
Gets the day view.
Gets the event storage.
public virtual ISchedulerStorage<IEvent> GetEventStorage()
Implements:
Creates a light visual element with an image of the specified element.
protected virtual LightVisualElement GetImageElement(RadElement element, Color backColor)
The element to create an image from.
backColorColorThe background color for the image.
Returns:A LightVisualElement containing the image of the specified element.
Gets the month view.
Gets the multi day view.
Gets the reminder storage.
public virtual ISchedulerStorage<IAppointmentReminderInfo> GetReminderStorage()
Implements:
Gets the resource storage.
public virtual ISchedulerStorage<IResource> GetResourceStorage()
Implements:
Gets the status storage.
public virtual ISchedulerStorage<IAppointmentStatusInfo> GetStatusStorage()
Implements:
Gets the timeline view.
protected virtual ViewData GetValuesByViewElement(SchedulerVisualElement viewElement)
Gets the week view.
protected virtual void HandleDayViewPan(PanGestureEventArgs args, SchedulerDayView view)
Handles pan gestures in the month view.
protected virtual void HandleMonthViewPan(PanGestureEventArgs args, SchedulerMonthView monthView)
The PanGestureEventArgs instance containing the event data.
monthViewSchedulerMonthViewThe month view instance.
protected virtual void HandleTimelineViewPan(PanGestureEventArgs args, SchedulerTimelineView timeLine)
Handles pan gestures in the week view.
protected virtual void HandleWeekViewPan(PanGestureEventArgs args, SchedulerWeekView weekView)
The PanGestureEventArgs instance containing the event data.
weekViewSchedulerWeekViewThe week view instance.
Imports the data from the specified stream into this RadScheduler instance, using the specified ISchedulerImporter instance.
public virtual void Import(Stream stream, ISchedulerImporter importer)
Imports the data from the specified string into this RadScheduler instance, using the specified ISchedulerImporter instance.
public virtual void Import(string stringData, ISchedulerImporter importer)
Loads the reminders from the specified stream.
public void LoadReminders(Stream stream)
The steam to load reminders from.
Loads the reminders from the specified file path.
public void LoadReminders(string filePath)
The path to the file to load reminders from.
Raises the ActiveViewChanged event.
protected virtual void OnActiveViewChanged(SchedulerView oldView, SchedulerView newView)
The previous active view.
newViewSchedulerViewThe new active view.
protected virtual bool OnActiveViewChanging(SchedulerView oldView, SchedulerView newView)
Called when appointments have been added.
protected virtual void OnAddAppointments(IList list)
The list of added appointments.
protected virtual void OnAppointmentAdded(AppointmentAddedEventArgs args)
protected virtual void OnAppointmentDeleted(SchedulerAppointmentEventArgs args)
protected virtual void OnAppointmentDeleting(SchedulerAppointmentCancelEventArgs args)
protected virtual void OnAppointmentDropped(AppointmentMovedEventArgs args)
protected virtual void OnAppointmentDropping(AppointmentMovingEventArgs args)
Raises the AppointmentEditDialogShowing event.
protected virtual IEditAppointmentDialog OnAppointmentEditDialogShowing(IEvent appointment, IEditAppointmentDialog dialog)
The appointment being edited.
dialogIEditAppointmentDialogThe edit appointment dialog instance.
Returns:IEditAppointmentDialog
The dialog to be shown, or null if the operation was canceled.
Raises the AppointmentElementDoubleClick event.
Raises the AppointmentElementMouseDown event.
protected virtual void OnAppointmentElementMouseDown(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the AppointmentElementMouseMove event.
protected virtual void OnAppointmentElementMouseMove(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the AppointmentElementMouseUp event.
protected virtual void OnAppointmentElementMouseUp(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the AppointmentFormatting event.
protected virtual void OnAppointmentFormatting(SchedulerAppointmentEventArgs args)
The SchedulerAppointmentEventArgs instance containing the event data.
protected virtual void OnAppointmentMouseDown(SchedulerAppointmentMouseEventArgs args)
protected virtual void OnAppointmentMouseUp(SchedulerAppointmentMouseEventArgs args)
protected virtual void OnAppointmentMoved(AppointmentMovedEventArgs args)
protected virtual void OnAppointmentMoving(AppointmentMovingEventArgs args)
Raises the event.
protected virtual void OnAppointmentRender(AppointmentRenderEventArgs args)
The AppointmentRenderEventArgs instance containing the event data.
protected virtual void OnAppointmentResized(AppointmentResizedEventArgs args)
protected virtual void OnAppointmentResizeStart(SchedulerAppointmentCancelEventArgs args)
protected virtual void OnAppointmentResizing(AppointmentResizingEventArgs args)
protected virtual void OnAppointmentsCopying(SchedulerClipboardEventArgs args)
protected virtual void OnAppointmentSelected(SchedulerAppointmentSelectedEventArgs args)
protected virtual void OnAppointmentSelecting(SchedulerAppointmentCancelEventArgs args)
protected virtual void OnAppointmentsPasting(SchedulerClipboardEventArgs args)
Raises the CellClick event.
protected virtual void OnCellClick(SchedulerCellEventArgs args)
The SchedulerCellEventArgs instance containing the event data.
Raises the CellElementDoubleClick event.
Raises the CellElementKeyDown event.
protected virtual void OnCellElementKeyDown(object sender, KeyEventArgs args)
The source of the event.
argsKeyEventArgsThe KeyEventArgs instance containing the event data.
Raises the CellElementKeyPress event.
protected virtual void OnCellElementKeyPress(object sender, KeyPressEventArgs args)
The source of the event.
argsKeyPressEventArgsThe KeyPressEventArgs instance containing the event data.
Raises the CellElementKeyUp event.
protected virtual void OnCellElementKeyUp(object sender, KeyEventArgs args)
The source of the event.
argsKeyEventArgsThe KeyEventArgs instance containing the event data.
Raises the CellElementMouseDown event.
protected virtual void OnCellElementMouseDown(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the CellElementMouseMove event.
protected virtual void OnCellElementMouseMove(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the CellElementMouseUp event.
protected virtual void OnCellElementMouseUp(object sender, MouseEventArgs args)
The source of the event.
argsMouseEventArgsThe MouseEventArgs instance containing the event data.
Raises the CellFormatting event.
protected virtual void OnCellFormatting(SchedulerCellEventArgs args)
The SchedulerCellEventArgs instance containing the event data.
Raises the CellOverflowButtonClicked event.
protected virtual bool OnCellOverflowButtonClicked(SchedulerCellEventArgs args)
The SchedulerCellEventArgs instance containing the event data.
Returns:true if the event was handled; otherwise, false.
Raises the event.
protected virtual void OnCellPaint(SchedulerCellPaintEventArgs args)
The SchedulerCellPaintEventArgs instance containing the event data.
protected virtual void OnCellSelectionChanging(SchedulerCellSelectingEventArgs args)
Raises the event.
protected virtual void OnContextMenuOpening(SchedulerContextMenuOpeningEventArgs e)
The SchedulerContextMenuOpeningEventArgs instance containing the event data.
Fires the CultureChanged event.
protected virtual void OnCultureChanged()
Raises the DataBindingComplete event.
Fired when the editor should be opened
protected virtual void OnEditorRequired(SchedulerEditorRequiredArgs args)
Notifies that the control is about to be visualized.
Handles pan gestures to enable touchscreen navigation and scrolling.
protected override void OnPanGesture(PanGestureEventArgs args)
The PanGestureEventArgs instance containing the event data.
Overrides:
Raises the RecurrenceDeleteDialogShowing event.
protected virtual IDeleteRecurringAppointmentDialog OnRecurrenceDeleteDialogShowing(IEvent appointment, IDeleteRecurringAppointmentDialog dialog)
The recurring appointment being deleted.
dialogIDeleteRecurringAppointmentDialogThe recurrence delete dialog instance.
Returns:IDeleteRecurringAppointmentDialog
The dialog to be shown, or null if the operation was canceled.
Raises the RecurrenceEditDialogShowing event.
protected virtual IEditRecurrenceDialog OnRecurrenceEditDialogShowing(IEvent appointment, IEditRecurrenceDialog dialog)
The recurring appointment being edited.
dialogIEditRecurrenceDialogThe recurrence edit dialog instance.
Returns:IEditRecurrenceDialog
The dialog to be shown, or null if the operation was canceled.
Called when appointments have been removed.
protected virtual void OnRemoveAppointments(IList list)
The list of removed appointments.
protected virtual void OnResourceStartIndexChanged()
protected virtual void OnResourceStartIndexChanging(ResourceIndexChangingEventArgs args)
Raises the event.
protected virtual void OnRulerTextFormatting(RulerTextFormattingEventArgs args)
The event arguments.
protected override void OnThemeChanged()
Overrides:
Called when appointments have to be refreshed.
protected virtual void OnUpdateAppointments()
protected virtual void OnViewNavigated(SchedulerViewNavigatedEventArgs args)
protected virtual void OnViewNavigating(SchedulerViewNavigatingEventArgs args)
Handles zoom gestures to enable changing views and scaling through pinch-to-zoom functionality.
protected override void OnZoomGesture(ZoomGestureEventArgs args)
The ZoomGestureEventArgs instance containing the event data.
Overrides:
Pastes the content from the clipboard to the scheduler.
public void Paste()
Directly prints the RadScheduler to the default printer.
public virtual void Print()
Directly prints the RadScheduler to the default printer or shows printer settitngs and then prints the RadGridView.
public virtual void Print(bool showPrinterSettings, RadPrintDocument document)
Indicates whether printer settings dialog should be shown.
documentRadPrintDocumentAs instance of RadPrintDocument used to control the print process.
Directly prints the RadScheduler to the default printer or shows printer settitngs and then prints the RadGridView.
public virtual void Print(bool showPrinterSettings)
Indicates whether printer settings dialog should be shown.
Shows a RadPrintPreviewDialog for editing the RadScheduler print settings. This method creates a new instance of RadPrintDocument and passes it to the overloaded PrintPreview method.
public virtual void PrintPreview()
Shows a RadPrintPreviewDialog for editing the RadScheduler print settings. This method temporarily changes the view type if needed and displays the print preview dialog.
public virtual void PrintPreview(RadPrintDocument document)
An instance of RadPrintDocument used to control the print process.
Saves all appointment reminders to the provided stream.
public void SaveReminders(Stream stream)
The stream to save the reminders to.
Saves all appointment reminders to the provided file. If the file does not exist it is created otherwise it is overwritten.
public void SaveReminders(string filePath)
The path to the file to save the reminders to.
protected virtual void SetValuesToViewElement(SchedulerVisualElement viewElement, ViewData viewData)
Shows the appointment edit dialog.
Displays the context menu associated with this control on the provided location.
public void ShowContextMenu(Point location)
The location where the context menu should open.
protected virtual void SynchronizeStartDate(SchedulerView oldView, SchedulerView newView)
protected virtual void SynchronizeViewsSettings(SchedulerView oldView, SchedulerView newView, ViewData viewData)
Events
Occurs when the ActiveView has changed.
public event EventHandler<SchedulerViewChangedEventArgs> ActiveViewChanged
Occurs when the ActiveView is about to change.
public event EventHandler<SchedulerViewChangingEventArgs> ActiveViewChanging
Occurs when the end user adds an appointment either with the EditAppointmentDialog or inline.
public event EventHandler<AppointmentAddedEventArgs> AppointmentAdded
Occurs when an appointment's property has changed.
public event EventHandler<AppointmentChangedEventArgs> AppointmentChanged
Occurs when the scheduler has deleted the selected appointment.
public event EventHandler<SchedulerAppointmentEventArgs> AppointmentDeleted
Occurs when the scheduler is deleting the selected appointment.
public event EventHandler<SchedulerAppointmentCancelEventArgs> AppointmentDeleting
Occurs when the an appointment has been dropped.
public event EventHandler<AppointmentMovedEventArgs> AppointmentDropped
Occurs when the an appointment is about to be dropped.
public event EventHandler<AppointmentMovingEventArgs> AppointmentDropping
Occurs when the EditAppointmentDialog is showing.
public event EventHandler<AppointmentEditDialogShowingEventArgs> AppointmentEditDialogShowing
Occurs when the DoubleClick event of an appointment element is fired.
public event EventHandler AppointmentElementDoubleClick
Occurs when the MouseDown event of an appointment element is fired.
public event MouseEventHandler AppointmentElementMouseDown
Occurs when the MouseMove event of an appointment element is fired.
public event MouseEventHandler AppointmentElementMouseMove
Occurs when the MouseUp event of an appointment element is fired.
public event MouseEventHandler AppointmentElementMouseUp
Occurs when an appointment element is prepared to be displayed. Use this event to modify visual properties of the AppointmentElement. Modifying data properties on the formatting events can result in exceptions.
public event EventHandler<SchedulerAppointmentEventArgs> AppointmentFormatting
Occurs when the MouseDown event of an appointment is fired.
public event EventHandler<SchedulerAppointmentMouseEventArgs> AppointmentMouseDown
Occurs when the MouseUp event of an appointment is fired.
public event EventHandler<SchedulerAppointmentMouseEventArgs> AppointmentMouseUp
Occurs when the an appointment has been moved.
public event EventHandler<AppointmentMovedEventArgs> AppointmentMoved
Occurs when the an appointment is about to be moved.
public event EventHandler<AppointmentMovingEventArgs> AppointmentMoving
Fires when an appointment print element is being formatted before it is printed.
public event PrintAppointmentEventHandler AppointmentPrintElementFormatting
Fires when an appointment print element is printed.
public event PrintAppointmentPaintEventHandler AppointmentPrintElementPaint
Occurs when appointment element is rendered.
public event AppointmentRenderHandler AppointmentRender
Occurs when the an appointment has been resized.
public event EventHandler<AppointmentResizedEventArgs> AppointmentResized
Occurs when the a resize operation has ended.
public event EventHandler<SchedulerAppointmentEventArgs> AppointmentResizeEnd
Occurs when the a rezie operation is starting. Cancelable.
public event EventHandler<SchedulerAppointmentCancelEventArgs> AppointmentResizeStart
Occurs when the an appointment is about to be resized.
public event EventHandler<AppointmentResizingEventArgs> AppointmentResizing
Fired by the Copy operation when the scheduler is about to prepare the clipboard data. This event allows you to cancel the default action and implement a custom one.
public event EventHandler<SchedulerClipboardEventArgs> AppointmentsCopying
Occurs when an appointment is selected.
public event EventHandler<SchedulerAppointmentSelectedEventArgs> AppointmentSelected
Occurs when an appointment will be selected.
public event EventHandler<SchedulerAppointmentCancelEventArgs> AppointmentSelecting
Fired by the Paste operation when the scheduler is about to read the clipboard data. This event allows you to cancel the default action and implement a custom one.
public event EventHandler<SchedulerClipboardEventArgs> AppointmentsPasting
Occurs when a cell is clicked.
public event EventHandler<SchedulerCellEventArgs> CellClick
Occurs when the DoubleClick event of the cell is fired.
public event EventHandler CellElementDoubleClick
Occurs when the KeyDown event of the cell is fired.
public event KeyEventHandler CellElementKeyDown
Occurs when the KeyPressed event of the cell is fired.
public event KeyPressEventHandler CellElementKeyPress
Occurs when the KeyUp event of the cell is fired.
public event KeyEventHandler CellElementKeyUp
Occurs when the MouseDown event of the cell is fired.
public event MouseEventHandler CellElementMouseDown
Occurs when the MouseMove event of the cell is fired.
public event MouseEventHandler CellElementMouseMove
Occurs when the MouseUp event of the cell is fired.
public event MouseEventHandler CellElementMouseUp
Fired when a cell element is being prepared for displaying. Use this event to modify visual properties of the SchedulerCellElement. Modifying data properties on the formatting events can result in exceptions.
public event EventHandler<SchedulerCellEventArgs> CellFormatting
Occurs when the overflow arrow of a cell in MonthView is clicked. When this event is handled, the default action of the overflow arrow is not executed.
public event EventHandler<SchedulerCellEventArgs> CellOverflowButtonClicked
Occurs after a cell is drawn. Allows custom painting over the cell element. EnableCustomCellDrawing must be set to true for this event to be fired.
public event EventHandler<SchedulerCellPaintEventArgs> CellPaint
Fires when a cell print element is being formatted before it is printed.
public event PrintSchedulerCellEventHandler CellPrintElementFormatting
Fires when a cell print element is printed.
public event PrintSchedulerCellPaintEventHandler CellPrintElementPaint
Occurs when the cell selection has changed.
public event EventHandler CellSelectionChanged
Occurs when the cell selection is about to change. Cancelable.
public event EventHandler<SchedulerCellSelectingEventArgs> CellSelectionChanging
Occurs before the context menu is opened.
public event SchedulerContextMenuOpeningEventHandler ContextMenuOpening
Occurs when culture has changed
public event EventHandler CultureChanged
Implements:
Occurs when the Data is loaded from the data source.
public event EventHandler DataBindingComplete
Occurs when an inline appointment editor is required.
public event EventHandler<SchedulerEditorRequiredArgs> EditorRequired
Fires when a print element is being formatted before it is printed.
public event PrintElementEventHandler PrintElementFormatting
Fires when a print element is printed.
public event PrintElementPaintEventHandler PrintElementPaint
Occurs when the DeleteRecurrenceDialog is showing.
public event EventHandler<RecurrenceDeleteDialogShowingEventArgs> RecurrenceDeleteDialogShowing
Occurs when the EditReccurenceDialog is showing.
public event EventHandler<RecurrenceEditDialogShowingEventArgs> RecurrenceEditDialogShowing
Occurs when the ResourceStartIndex has changed. Fired only when grouping by resource.
public event EventHandler ResourceStartIndexChanged
Occurs when the ResourceStartIndex is about to change. Cancelable. Fired only when grouping by resource.
public event EventHandler<ResourceIndexChangingEventArgs> ResourceStartIndexChanging
Occurs when the text of a ruler is drawn.
public event EventHandler<RulerTextFormattingEventArgs> RulerTextFormatting
Occurs when the view has changed and this is caused by a click on the ViewNavigationElement.
public event EventHandler<SchedulerViewNavigatedEventArgs> ViewNavigated
Occurs when the view is about to change and this is caused by a click on the ViewNavigationElement.
public event EventHandler<SchedulerViewNavigatingEventArgs> ViewNavigating