New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial
SchedulerAppointment Object
The SchedulerAppointment client-side object represents a single instance of an Appointment.
The tables below lists the most important, public properties of the SchedulerAppointment client-side object.
Properties
| Name | Parameters | Return Type | Description |
|---|---|---|---|
| get_allowDelete() set_allowDelete() | NoneBoolean | BooleanNone | Gets or sets a Boolean value indicating whether the Appointment can be deleted. |
| get_allowEdit() set_allowEdit() | NoneBoolean | BooleanNone | Gets or sets a Boolean value indicating whether the Appointment can be edited. |
| get_attributes() | None | SchedulerAttributeCollection | Gets all Attributes of the Appointment. |
| get_backColor() set_backColor() | NoneString | StringNone | Gets or sets the backColor of the Appointment. |
| get_borderColor() set_borderColor() | NoneString | StringNone | Gets or sets the borderColor of the Appointment. |
| get_borderStyle() set_borderStyle() | NoneString | StringNone | Gets or sets the borderStyle of the Appointment.(Works only if the AppointmentStyleMode="Simple" ) |
| get_borderWidth() set_borderWidth() | NoneString | StringNone | Gets or sets the borderWidth of the Appointment.(Works only if the AppointmentStyleMode="Simple" ) |
| get_contextMenu() | None | ContextMenu | Gets the ContextMenu of the Appointment. See Example 1. |
| get_cssClass() set_cssClass() | NoneString | StringNone | Gets or sets the cssClass of the Appointment. |
| get_description() set_description() | NoneString | StringNone | Gets or sets the description of the Appointment. |
| get_duration() | None | Int | Gets the duration of the Appointment in milliseconds. |
| get_durationInMinutes() | None | Int | Gets the duration of the Appointment in minutes. |
| get_element() | None | DomElement | Gets the DomElement representing the Appointment. |
| get_elements() | None | Array of DomElements | Gets all DomElements that represent this appointment (for multi-part appointments) |
| get_end() set_end() | NoneDate | DateNone | Gets or sets the end date of the Appointment. |
| get_id() | None | Int | Gets the ID of the Appointment |
| get_radScheduler() | None | RadScheduler | Gets the owner Scheduler. |
| get_recurrenceParentID() | None | Int / undefined | Gets the ID of the parent Appointment if the current Appointment is recurrent or 'undefined' otherwise. |
| get_recurrenceState() | None | Telerik.Web.UI.RecurrenceState or int | Gets the recurrence state of the Appointment. RecurrenceState can be: NotRecurring or 0, Master or 1, Occurrence or 2, Exception or 3 |
| get_recurrenceRule() | None | String | Gets the recurrence rule of the Appointment if it is "Master" and WebService binding is used or 'undefined' otherwise. See Example 2. |
| get_reminders() | None | Telerik.Web.UI.ReminderCollection | Gets a collection of reminders for the Appointment |
| get_resources() | None | Telerik.Web.UI.SchedulerResourceCollection | Gets a collection of resources for the Appointment |
| get_start() set_start() | NoneDate | DateNone | Gets or sets the start date of the Appointment. |
| get_subject() set_subject() | NoneString | StringNone | Gets or sets the subject of the Appointment. The properties set_subject() , set_start() and set_end() will persist after postback. See Example 3. |
| get_selected() set_selected() | NoneBoolean | BooleanNone | Gets or sets a Boolean value indicating whether the Appointment is selected. |
| get_timeSlot() | None | TimeSlot | Gets the asociated time slot object for the current Appointment. |
| get_toolTip() set_toolTip() | NoneString | StringNone | Gets or sets the ToolTip of the Appointment. |
| get_visible() | None | Boolean | Gets a Boolean value indicating whether the Appointment is visible. |
| _isAllDay() | None | Boolean | Gets a Boolean value indicating whether the Appointment's duration is all day or not. |
| clone() | None | Appointment | Creats a new Appointment that is copy of the instant one. See Example 4. |
Example 1: Get the Appointment's ContextMenu.
JavaScript
function OnClientAppointmentClick(sender, args) {
var contextMenu = args.get_appointment().get_contextMenu();
contextMenu.show(args.get_domEvent());
}
Example 2: Gets the Appointment's recurrence rule.
JavaScript
function OnClientAppointmentClick(sender, args) {
var appointment = args.get_appointment();
appointment.set_allowEdit(true);
var description = appointment.get_description();
if (appointment.get_recurrenceState() == Telerik.Web.UI.RecurrenceState.NotRecurring) {
appointment.set_description("This appointment is not recurring.");
}
else if (appointment.get_recurrenceState() == Telerik.Web.UI.RecurrenceState.Master) {
var rrule = appointment.get_recurrenceRule();
appointment.set_description(rrule);
}
else if (appointment.get_recurrenceState() == Telerik.Web.UI.RecurrenceState.Occurrence) {
appointment.set_description("This is an occurence.");
}
else if (appointment.get_recurrenceState() == Telerik.Web.UI.RecurrenceState.Exception) {
appointment.set_description("This is an exception.");
}
}
Example 3: Set properties that will persist after postback.
JavaScript
function OnClientAppointmentClick(sender, args)
{
var appointment = args.get_appointment();
var subject = appointment.get_subject();
appointment.set_subject("new" + subject);
var start = appointment.get_start();
var newStart = new Date(start);
newStart.setMinutes(newStart.getMinutes() - 45);
app.set_start(newStart);
var end = appointment.get_end();
var newEnd = new Date(end);
newEnd.setMinutes(newEnd.getMinutes() + 45);
appointment.set_end(newEnd);
sender.updateAppointment(appointment);
}
The other setters can update the appointment in case of WebService binding where there is NO postback and the onClientAppointmentDataBound is fired.
JavaScript
function OnClientAppointmentDataBound(sender, args)
{
var appointment = args.get_appointment();
appointment.set_backColor("red");
appointment.get_attributes().setAttribute("Loacation", "Sofia");
appointment.set_description("description");
appointment.set_borderColor("red");
appointment.set_borderStyle("dotted");
appointment.set_borderWidth(1);
appointment.set_allowDelete(false);
appointment.set_allowEdit(false);
}
Example 4: Create a copy Appointment.
JavaScript
function onClientAppointmentClick(sender, args)
{
var appointment = args.get_appointment();
var newAppointment = app.clone();
sender.insertAppointment(newAppointment);
}