Class VTodo
java.lang.Object
- All Implemented Interfaces:
VAttendee<VTodo>, VComponent, VDescribable<VTodo>, VDescribable2<VTodo>, VDuration<VTodo>, VLastModified<VTodo>, VRepeatable<VTodo>, VChild, VElement, VParent
VTODO
To-Do Component
RFC 5545, 3.6.2, page 55
A "VTODO" calendar component is a grouping of component
properties and possibly "VALARM" calendar components that
represent an action-item or assignment. For example, it can be
used to represent an item of work assigned to an individual; such
as "turn in travel expense today".
The "VTODO" calendar component cannot be nested within another
calendar component. However, "VTODO" calendar components can be
related to each other or to a "VEVENT" or to a "VJOURNAL" calendar
component with the "RELATED-TO" property.
A "VTODO" calendar component without the "DTSTART" and "DUE" (or
"DURATION") properties specifies a to-do that will be associated
with each successive calendar date, until it is completed.
Examples: The following is an example of a "VTODO" calendar
component that needs to be completed before May 1st, 2007. On
midnight May 1st, 2007 this to-do would be considered overdue.
BEGIN:VTODO
UID:20070313T123432Z-456553@example.com
DTSTAMP:20070313T123432Z
DUE;VALUE=DATE:20070501
SUMMARY:Submit Quebec Income Tax Return for 2006
CLASS:CONFIDENTIAL
CATEGORIES:FAMILY,FINANCE
STATUS:NEEDS-ACTION
END:VTODO
-
Nested Class Summary
Nested classes/interfaces inherited from class VElementBase
VElementBase.Message, VElementBase.MessageEffectNested classes/interfaces inherited from interface VRepeatable
VRepeatable.MergedIterator<T> -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate DateTimeCompletedCOMPLETED: Date-Time Completed RFC 5545 iCalendar 3.8.2.1 page 94 This property defines the date and time that a to-do was actually completed.private DateTimeDueDUE: Date-Time Due RFC 5545 iCalendar 3.8.2.3 page 96 This property defines the date and time that a to-do is expected to be completed.private PercentCompletePERCENT-COMPLETE RFC 5545 iCalendar 3.8.1.8.Fields inherited from class VPrimary
DTSTART_COMPARATORFields inherited from class VComponentBase
parentFields inherited from class VParentBase
contentLineGenerator, ordererFields inherited from class VElementBase
BEGIN, END -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidErase all date/time properties such as DTSTART, DTEND, DURATION, and DUE (which ever exist).errors()/ if (useRequestStatus) / { // Set REQUEST-STATUS for each message / statusMessages.entrySet() / .stream() / .flatMap(e -> e.getValue().stream()) / .forEach(e -> addChild(RequestStatus.parse(e))); / }A convenience method that returns either Duration property value, or a calculated duration based on start and end valuesstatic VTodoCreates a new VTodo calendar component by parsing a String of iCalendar content linesvoidsetDateTimeCompleted(String dateTimeCompleted) voidsetDateTimeCompleted(ZonedDateTime dateTimeCompleted) voidsetDateTimeCompleted(DateTimeCompleted dateTimeCompleted) voidsetDateTimeDue(String dateTimeDue) voidsetDateTimeDue(Temporal dateTimeDue) voidsetDateTimeDue(DateTimeDue dateTimeDue) voidsetDuration(DurationProp duration) Sets the value of theDurationPropvoidsetEndOrDuration(Temporal startRecurrence, Temporal endRecurrence) A convenience method that sets DTEND, DURATION (VEvent) or DUE (VTodo) depending on which ever is already set to new value calculated by the duration or period between input parameters (depending on if the parameters are LocalDate or a date/time type (i.e.voidsetPercentComplete(Integer percentComplete) voidsetPercentComplete(String percentComplete) voidsetPercentComplete(PercentComplete percentComplete) withDateTimeCompleted(String dateTimeCompleted) withDateTimeCompleted(ZonedDateTime dateTimeCompleted) withDateTimeCompleted(DateTimeCompleted dateTimeCompleted) withDateTimeDue(String dateTimeDue) withDateTimeDue(Temporal dateTimeDue) withDateTimeDue(DateTimeDue dateTimeDue) withPercentComplete(Integer percentComplete) withPercentComplete(String percentComplete) withPercentComplete(PercentComplete percentComplete) Methods inherited from class VLocatable
addSubcomponent, getDescription, getDuration, getGeographicPosition, getLocation, getPriority, getResources, getVAlarms, hashCode, setDescription, setGeographicPosition, setGeographicPosition, setGeographicPosition, setLocation, setLocation, setPriority, setPriority, setPriority, setResources, setVAlarms, streamRecurrences, withGeographicPosition, withGeographicPosition, withGeographicPosition, withLocation, withLocation, withPriority, withPriority, withPriority, withResources, withResources, withResources, withVAlarms, withVAlarms, withVAlarmsMethods inherited from class VDisplayable
checkRecurrenceIdConsistency, dateTimeStartListenerHook, getAttachments, getCategories, getClassification, getContacts, getDateTimeCreated, getDateTimeLastModified, getExceptionDates, getRecurrenceDates, getRecurrenceId, getRecurrenceRule, getRelatedTo, getSequence, getStatus, getSummary, incrementSequence, orphanedRecurrenceChildren, recurrenceCache, recurrenceChildren, recurrenceParent, setAttachments, setCategories, setClassification, setClassification, setClassification, setContacts, setDateTimeCreated, setDateTimeCreated, setDateTimeCreated, setDateTimeLastModified, setExceptionDates, setRecurrenceDates, setRecurrenceId, setRecurrenceId, setRecurrenceId, setRecurrenceRule, setRelatedTo, setSequence, setSequence, setSequence, setStatus, setStatus, setStatus, setSummary, withCategories, withCategories, withCategories, withClassification, withClassification, withClassification, withContacts, withContacts, withContacts, withDateTimeCreated, withDateTimeCreated, withDateTimeCreated, withExceptionDates, withExceptionDates, withExceptionDates, withExceptionDates, withRecurrenceId, withRecurrenceId, withRecurrenceId, withRelatedTo, withRelatedTo, withRelatedTo, withSequence, withSequence, withSequence, withStatus, withStatus, withStatusMethods inherited from class VPersonal
getAttendees, getDateTimeStamp, getOrganizer, getRequestStatus, getUidGeneratorCallback, getUniqueIdentifier, getURL, setAttendees, setDateTimeStamp, setDateTimeStamp, setDateTimeStamp, setOrganizer, setOrganizer, setRequestStatus, setUidGeneratorCallback, setUniqueIdentifier, setUniqueIdentifier, setUniqueIdentifier, setURL, setURL, setURL, withDateTimeStamp, withDateTimeStamp, withDateTimeStamp, withOrganizer, withOrganizer, withRequestStatus, withRequestStatus, withRequestStatus, withUidGeneratorCallback, withUniqueIdentifier, withUniqueIdentifier, withUniqueIdentifier, withURL, withURL, withURLMethods inherited from class VPrimary
getComments, getDateTimeStart, isWholeDay, setComments, setDateTimeStart, setDateTimeStart, setDateTimeStart, withComments, withComments, withComments, withDateTimeStart, withDateTimeStart, withDateTimeStartMethods inherited from class VCommon
getNonStandard, setNonStandard, withNonStandard, withNonStandard, withNonStandardMethods inherited from class VComponentBase
getParent, isContentValid, name, setParentMethods inherited from class VParentBase
addChild, addChild, addChild, addChildInternal, checkChild, childrenUnmodifiable, collectGetterMap, collectSetterMap, copyChildrenInto, equals, getGetter, getGetters, getSetter, getSetters, orderChild, orderChild, orderChild, parseContent, parseContent, processInLineChild, removeChild, removeChild, replaceChild, replaceChild, toString, withChildMethods inherited from class VElementBase
elementName, newEmptyVElement, parse, throwMessageExceptionsMethods inherited from interface VAttendee
withAttendees, withAttendees, withAttendeesMethods inherited from interface VComponent
toStringMethods inherited from interface VDescribable
getAttachments, getSummary, setAttachments, setSummary, setSummary, withAttachments, withAttachments, withAttachments, withSummary, withSummaryMethods inherited from interface VDescribable2
getDescription, setDescription, setDescription, withDescription, withDescriptionMethods inherited from interface VDuration
setDuration, setDuration, withDuration, withDuration, withDurationMethods inherited from interface VLastModified
setDateTimeLastModified, setDateTimeLastModified, withDateTimeLastModified, withDateTimeLastModified, withDateTimeLastModifiedMethods inherited from interface VParent
addChild, addChild, addChild, childrenUnmodifiable, orderChild, orderChild, orderChild, removeChild, removeChild, replaceChild, replaceChildMethods inherited from interface VRepeatable
checkDateTimeStartConsistency, checkRecurrencesConsistency, getDateTimeStart, isRecurrence, isRecurrenceSetEmpty, lastRecurrence, previousStreamValue, setRecurrenceRule, setRecurrenceRule, streamRecurrences, streamRecurrences, withRecurrenceDates, withRecurrenceDates, withRecurrenceDates, withRecurrenceDates, withRecurrenceRule, withRecurrenceRule, withRecurrenceRule
-
Field Details
-
dateTimeCompleted
COMPLETED: Date-Time Completed RFC 5545 iCalendar 3.8.2.1 page 94 This property defines the date and time that a to-do was actually completed. The value MUST be specified in the UTC time format. Example: COMPLETED:19960401T150000Z -
dateTimeDue
DUE: Date-Time Due RFC 5545 iCalendar 3.8.2.3 page 96 This property defines the date and time that a to-do is expected to be completed. the value type of this property MUST be the same as the "DTSTART" property Example: DUE:TZID=America/Los_Angeles:19970512T090000 -
percentComplete
PERCENT-COMPLETE RFC 5545 iCalendar 3.8.1.8. page 88 This property is used by an assignee or delegatee of a to-do to convey the percent completion of a to-do to the "Organizer". The property value is a positive integer between 0 and 100. A value of "0" indicates the to-do has not yet been started. A value of "100" indicates that the to-do has been completed. Example: The following is an example of this property to show 39% completion: PERCENT-COMPLETE:39
-
-
Constructor Details
-
VTodo
public VTodo() -
VTodo
-
-
Method Details
-
getDateTimeCompleted
-
setDateTimeCompleted
-
setDateTimeCompleted
-
setDateTimeCompleted
-
withDateTimeCompleted
-
withDateTimeCompleted
-
withDateTimeCompleted
-
getDateTimeDue
-
setDateTimeDue
-
setDateTimeDue
-
setDateTimeDue
-
withDateTimeDue
-
withDateTimeDue
-
withDateTimeDue
-
setDuration
Description copied from interface:VDurationSets the value of theDurationProp- Specified by:
setDurationin interfaceVDuration<VTodo>- Overrides:
setDurationin classVLocatable<VTodo>
-
getPercentComplete
-
setPercentComplete
-
setPercentComplete
-
setPercentComplete
-
withPercentComplete
-
withPercentComplete
-
withPercentComplete
-
calendarList
- Specified by:
calendarListin interfaceVComponent
-
getActualDuration
Description copied from class:VLocatableA convenience method that returns either Duration property value, or a calculated duration based on start and end values- Specified by:
getActualDurationin classVLocatable<VTodo>
-
setEndOrDuration
Description copied from class:VLocatableA convenience method that sets DTEND, DURATION (VEvent) or DUE (VTodo) depending on which ever is already set to new value calculated by the duration or period between input parameters (depending on if the parameters are LocalDate or a date/time type (i.e. ZonedDateTime)) Note: In order to set DTEND, DTSTART must be assigned a value. DURATION and DUE doesn't require a DTSTART value.- Specified by:
setEndOrDurationin classVLocatable<VTodo>- Parameters:
startRecurrence-endRecurrence-
-
errors
Description copied from class:VPersonal/ if (useRequestStatus) / { // Set REQUEST-STATUS for each message / statusMessages.entrySet() / .stream() / .flatMap(e -> e.getValue().stream()) / .forEach(e -> addChild(RequestStatus.parse(e))); / }- Specified by:
errorsin interfaceVElement- Overrides:
errorsin classVLocatable<VTodo>- Returns:
- - list of error messages
-
eraseDateTimeProperties
public void eraseDateTimeProperties()Description copied from class:VDisplayableErase all date/time properties such as DTSTART, DTEND, DURATION, and DUE (which ever exist). This is necessary to prepare a CANCEL iTIP message for one recurrence instance.- Overrides:
eraseDateTimePropertiesin classVLocatable<VTodo>
-
parse
-