New to Telerik UI for ASP.NET AJAX? Download 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.


 function OnClientAppointmentClick(sender, args) {
    var contextMenu = args.get_appointment().get_contextMenu();
    contextMenu.show(args.get_domEvent());
}

Example 2: Gets the Appointment's recurrence rule.


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.


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.


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.


function onClientAppointmentClick(sender, args)
{
     var appointment = args.get_appointment();
     var newAppointment = app.clone();
     sender.insertAppointment(newAppointment);
}      

See Also

In this article