Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
3/29/2010

Defines a Task item in the Task collection. Tasks represent actionable "ToDo" items that can be prioritized (using Low, Normal, and High), delegated (by creating a Task Request, or using Assign Task), and completed (using % Complete).

The following tables list the members exposed by the Tasktype.

Public Constructors

  Name Description
Task Overloaded.  
Top

Public Properties

  Name Description
Body Gets or sets the text of the notes accompanying a task. The maximum size is 60 KB.
Categories Gets or sets the categories assigned to the task. Maximum length is 1023 characters.
Complete Gets or sets whether the task is completed. TRUE if complete, FALSE otherwise. The default is FALSE. TRUE sets the DateCompleted property to the current date on the device.
DateCompleted Gets when the task is completed. It gets set to the current date on the device when you set the Complete property. Dates must be set between 1/1/1900 and 12/31/2999 inclusive.
DueDate Gets or sets when the task is due. Dates must be set between 1/1/1900 and 12/31/2999 inclusive. The default is DATE_NONE.
Importance Gets or sets the importance of the meeting. Allowed settings are ImportanceLow, ImportanceNormal (default), or ImportanceHigh.
IsRecurring Returns whether the task is recurring. This is useful to use in a restriction string, to quickly discern whether a task recurs.
ItemId  Gets the PIM item’s ID. (inherited from PimItem)
Properties  Gets the PimPropertySet. This object is used for creating custom PIM item properties. (inherited from PimItem)
RecurrencePattern Gets the Recurrence object for the Task.
ReminderDialog Gets or sets a value indicating whether a reminder dialog will appear when the reminder occurs.
ReminderLed Gets or sets a value indicating whether the LED (light emitting diode) will activate when the reminder occurs.
ReminderRepeat Gets or sets a value indicating whether the reminder sound file will repeat until the reminder is dismissed.
ReminderSet Gets or sets whether the user wants to be reminded of a task. The default for this is the user setting in the Calendar and Task Options dialog box.
ReminderSound Gets or sets a value indicating whether the reminder sound file will play when the reminder occurs.
ReminderSoundFile Gets or sets the path and file name of the sound file to play when the reminder occurs for the Task. This property is valid only if the ReminderSet property is TRUE and the ReminderOptions property includes Sound. The default for this is the current setting for the Calendar application or Alarm1.wav if none. Maximum length is 255 characters.
ReminderTime Gets or sets the number of minutes a reminder occurs before the start of a task. The default for this is the user setting in the Calendar Options dialog box.
ReminderVibrate Gets or sets a value indicating whether the device will vibrate when the reminder occurs.
Sensitivity Gets or sets the sensitivity for a task as normal (Normal) or private (Private). The default for a new task is Normal.
StartDate Gets or sets when the task starts. StartDate must be less than or equal to DateCompleted. Dates must be set between 1/1/1900 and 12/31/2999 inclusive. The default is DATE_NONE.
Subject Gets or sets the subject for the task. Maximum length is 4095 characters.
TeamTask Gets or sets whether the task is a team task. TRUE if a team task.
Top

Public Methods(see also Protected Methods)

  Name Description
Copy Creates an in-memory copy of the Task.
CreateObjRef  (inherited from MarshalByRefObject)
Delete Overloaded.  
Equals  Overloaded. (inherited from Object)
GetHashCode  (inherited from Object)
GetLifetimeService  (inherited from MarshalByRefObject)
GetType  (inherited from Object)
InitializeLifetimeService  (inherited from MarshalByRefObject)
ReferenceEquals  (inherited from Object)
ShowDialog  Opens the PIM item’s standard summary card. (inherited from PimItem)
ToString Overridden. Gets the Task's subject line.
Update Overridden. Updates the Task by saving its changes to the Task collection.
Top

Protected Methods

  Name Description
Delete  Overloaded. (inherited from PimItem)
Finalize  The PimItem class destructor. (inherited from PimItem)
MemberwiseClone  (inherited from Object)
Top

Public Events

  Name Description
BodyChanged Occurs when the Task's body text changes.
CategoriesChanged Occurs when the Task's assigned categories change.
CompleteChanged Occurs when the Task's complete flag changes.
DueDateChanged Occurs when the Task's due date changes.
ImportanceChanged Occurs when the Task's importance level changes.
ReminderDialogChanged Occurs when the Task's reminder dialog changes.
ReminderLedChanged Occurs when the LED reminder flag changes.
ReminderRepeatChanged Occurs when the Task's reminder repeat flag changes.
ReminderSetChanged Occurs when the Reminder Exists flag changes.
ReminderSoundChanged Occurs when the Task's reminder sound flag changes.
ReminderSoundFileChanged Occurs when the Task's reminder sound file changes.
ReminderTimeChanged Occurs when the Task's reminder time changes.
ReminderVibrateChanged Occurs when the Vibrate flag changes.
SensitivityChanged Occurs when the Task's sensitivity level changes.
StartDateChanged Occurs when the Task's start date changes.
SubjectChanged Occurs when the Task's subject changes.
TeamTaskChanged Occurs when the team task flag changes.
Top

See Also