Share via

Task Members

  • Article

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 Task type.

Public Constructors

  Name Description
Task Overloaded.  

Top

Public Properties

  Name Description
Aa455699.pubproperty(en-us,MSDN.10).gif Body Gets or sets the text of the notes accompanying a task. The maximum size is 60 KB.
Aa455699.pubproperty(en-us,MSDN.10).gif Categories Gets or sets the categories assigned to the task. Maximum length is 1023 characters.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif Importance Gets or sets the importance of the meeting. Allowed settings are ImportanceLow, ImportanceNormal (default), or ImportanceHigh.
Aa455699.pubproperty(en-us,MSDN.10).gif IsRecurring Returns whether the task is recurring. This is useful to use in a restriction string, to quickly discern whether a task recurs.
Aa455699.pubproperty(en-us,MSDN.10).gif ItemId  Gets the PIM item’s ID. (inherited from PimItem)
Aa455699.pubproperty(en-us,MSDN.10).gif Properties  Gets the PimPropertySet. This object is used for creating custom PIM item properties. (inherited from PimItem)
Aa455699.pubproperty(en-us,MSDN.10).gif RecurrencePattern Gets the Recurrence object for the Task.
Aa455699.pubproperty(en-us,MSDN.10).gif ReminderDialog Gets or sets a value indicating whether a reminder dialog will appear when the reminder occurs.
Aa455699.pubproperty(en-us,MSDN.10).gif ReminderLed Gets or sets a value indicating whether the LED (light emitting diode) will activate when the reminder occurs.
Aa455699.pubproperty(en-us,MSDN.10).gif ReminderRepeat Gets or sets a value indicating whether the reminder sound file will repeat until the reminder is dismissed.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif ReminderSound Gets or sets a value indicating whether the reminder sound file will play when the reminder occurs.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif ReminderVibrate Gets or sets a value indicating whether the device will vibrate when the reminder occurs.
Aa455699.pubproperty(en-us,MSDN.10).gif Sensitivity Gets or sets the sensitivity for a task as normal (Normal) or private (Private). The default for a new task is Normal.
Aa455699.pubproperty(en-us,MSDN.10).gif 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.
Aa455699.pubproperty(en-us,MSDN.10).gif Subject Gets or sets the subject for the task. Maximum length is 4095 characters.
Aa455699.pubproperty(en-us,MSDN.10).gif 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
Aa455699.pubmethod(en-us,MSDN.10).gif Copy Creates an in-memory copy of the Task.
Aa455699.pubmethod(en-us,MSDN.10).gif CreateObjRef  (inherited from MarshalByRefObject )
Aa455699.pubmethod(en-us,MSDN.10).gif Delete Overloaded.  
Aa455699.pubmethod(en-us,MSDN.10).gif Equals  Overloaded. (inherited from Object )
Aa455699.pubmethod(en-us,MSDN.10).gif GetHashCode  (inherited from Object )
Aa455699.pubmethod(en-us,MSDN.10).gif GetLifetimeService  (inherited from MarshalByRefObject )
Aa455699.pubmethod(en-us,MSDN.10).gif GetType  (inherited from Object )
Aa455699.pubmethod(en-us,MSDN.10).gif InitializeLifetimeService  (inherited from MarshalByRefObject )
Aa455699.pubmethod(en-us,MSDN.10).gif Aa455699.static(en-us,MSDN.10).gif ReferenceEquals  (inherited from Object )
Aa455699.pubmethod(en-us,MSDN.10).gif ShowDialog  Opens the PIM item’s standard summary card. (inherited from PimItem)
Aa455699.pubmethod(en-us,MSDN.10).gif ToString Overridden. Gets the Task's subject line.
Aa455699.pubmethod(en-us,MSDN.10).gif Update Overridden. Updates the Task by saving its changes to the Task collection.

Top

Protected Methods

  Name Description
Aa455699.protmethod(en-us,MSDN.10).gif Delete  Overloaded. (inherited from PimItem )
Aa455699.protmethod(en-us,MSDN.10).gif Finalize  The PimItem class destructor. (inherited from PimItem)
Aa455699.protmethod(en-us,MSDN.10).gif MemberwiseClone  (inherited from Object )

Top

Public Events

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

Top

See Also

Reference

Task Class
Microsoft.WindowsMobile.PocketOutlook Namespace