Module ical4j.core

Class Status

All Implemented Interfaces:
Serializable, Comparable<Property>, FluentProperty, Prototype<Property>
Direct Known Subclasses:
ImmutableStatus

public class Status extends Property
$Id$

Created: [Apr 6, 2004]

Defines a STATUS iCalendar component property.

     4.8.1.11 Status

        Property Name: STATUS

        Purpose: This property defines the overall status or confirmation for
        the calendar component.

        Value Type: TEXT

        Property Parameters: Non-standard property parameters can be
        specified on this property.

        Conformance: This property can be specified in "VEVENT", "VTODO" or
        "VJOURNAL" calendar components.

        Description: In a group scheduled calendar component, the property is
        used by the "Organizer" to provide a confirmation of the event to the
        "Attendees". For example in a "VEVENT" calendar component, the
        "Organizer" can indicate that a meeting is tentative, confirmed or
        cancelled. In a "VTODO" calendar component, the "Organizer" can
        indicate that an action item needs action, is completed, is in
        process or being worked on, or has been cancelled. In a "VJOURNAL"
        calendar component, the "Organizer" can indicate that a journal entry
        is draft, final or has been cancelled or removed.

        Format Definition: The property is defined by the following notation:

          status     = "STATUS" statparam] ":" statvalue CRLF

          statparam  = *(";" xparam)

          statvalue  = "TENTATIVE"           ;Indicates event is
                                             ;tentative.
                     / "CONFIRMED"           ;Indicates event is
                                             ;definite.
                     / "CANCELLED"           ;Indicates event was
                                             ;cancelled.
             ;Status values for a "VEVENT"

          statvalue  =/ "NEEDS-ACTION"       ;Indicates to-do needs action.
                     / "COMPLETED"           ;Indicates to-do completed.
                     / "IN-PROCESS"          ;Indicates to-do in process of
                     / "CANCELLED"           ;Indicates to-do was cancelled.
             ;Status values for "VTODO".

          statvalue  =/ "DRAFT"              ;Indicates journal is draft.
                     / "FINAL"               ;Indicates journal is final.
                     / "CANCELLED"           ;Indicates journal is removed.
             ;Status values for "VJOURNAL".

        Example: The following is an example of this property for a "VEVENT"
        calendar component:

          STATUS:TENTATIVE

        The following is an example of this property for a "VTODO" calendar
        component:

          STATUS:NEEDS-ACTION

        The following is an example of this property for a "VJOURNAL"
        calendar component:

          STATUS:DRAFT
 
See Also: