TaskItem Object Members

Outlook Developer Reference

Represents a task (an assigned, delegated, or self-imposed task to be performed within a specified time frame) in a Tasks folder.

Methods

	Name	Description
	Assign	Assigns a task and returns a TaskItem object that represents it.
	CancelResponseState	Resets an unsent response to a task request back to a simple task.
	ClearRecurrencePattern	Removes the recurrence settings and restores the single-occurrence state for an appointment or task.
	Close	Closes and optionally saves changes to the Outlook item.
	Copy	Creates another instance of an object.
	Delete	Deletes an object from the collection.
	Display	Displays a new Inspector object for the item.
	GetRecurrencePattern	Returns a RecurrencePattern object that represents the recurrence attributes of a task. If there is no existing recurrence pattern, a new empty RecurrencePattern object is returned.
	MarkComplete	Marks the task as completed.
	Move	Moves a Microsoft Outlook item to a new folder.
	PrintOut	Prints the Outlook item using all default settings.The PrintOut method is the only Outlook method that can be used for printing.
	Respond	Responds to a task request.
	Save	Saves the Microsoft Outlook item to the current folder or, if this is a new item, to the Outlook default folder for the item type.
	SaveAs	Saves the Microsoft Outlook item to the specified path and in the format of the specified file type. If the file type is not specified, the MSG format (.msg) is used.
	Send	Sends the task.
	ShowCategoriesDialog	Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.
	SkipRecurrence	Clears the current instance of a recurring task and sets the recurrence to the next instance of that task.
	StatusReport	Sends a status report to all Cc recipients (recipients returned by the StatusUpdateRecipients property) with the current status for the task and returns an Object representing the status report.

Properties

	Name	Description
	Actions	Returns an Actions collection that represents all the available actions for the item. Read-only.
	ActualWork	Returns or sets a Long indicating the actual effort spent on the task. Read/write.
	Application	Returns an Application object that represents the parent Outlook application for the object. Read-only.
	Attachments	Returns an Attachments object that represents all the attachments for the specified item. Read-only.
	AutoResolvedWinner	Returns a Boolean that determines if the item is a winner of an automatic conflict resolution. Read-only.
	BillingInformation	Returns or sets a String representing the billing information associated with the Outlook item. Read/write.
	Body	Returns or sets a String representing the clear-text body of the Outlook item. Read/write.
	CardData	Returns or sets a String representing the text of the card data for the task. Read/write.
	Categories	Returns or sets a String representing the categories assigned to the Outlook item. Read/write.
	Class	Returns an OlObjectClass constant indicating the object's class. Read-only.
	Companies	Returns or sets a String representing the names of the companies associated with the Outlook item. Read/write.
	Complete	Returns True if the task is completed. Read/write Boolean.
	Conflicts	Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.
	ContactNames	Returns or sets a String representing the contact names associated with the Outlook item. Read/write.
	ConversationIndex	Returns a String representing the index of the conversation thread of the Outlook item. Read-only.
	ConversationTopic	Returns a String representing the topic of the conversation thread of the Outlook item. Read-only.
	CreationTime	Returns a Date indicating the creation time for the Outlook item. Read-only.
	DateCompleted	Returns or sets a Date indicating the completion date of the task. Read/write.
	DelegationState	Returns an OlTaskDelegationState constant indicating the delegation state of the task. Read-only.
	Delegator	Returns a String representing the display name of the delegator for the task. Read-only.
	DownloadState	Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.
	DueDate	Returns or sets a Date indicating the due date for the task. Read/write.
	EntryID	Returns a String representing the unique Entry ID of the object. Read-only.
	FormDescription	Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.
	GetInspector	Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.
	Importance	Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.
	InternetCodepage	Returns or sets a Long that determines the Internet code page used by the item. Read/write.
	IsConflict	Returns a Boolean that determines if the item is in conflict. Read-only.
	IsRecurring	Returns a Boolean value that is True if the task is a recurring task. Read-only.
	ItemProperties	Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.
	LastModificationTime	Returns a Date specifying the date and time that the Outlook item was last modified. Read-only.
	Links	Returns a Links collection that represents the contacts to which the item is linked. Read-only.
	MarkForDownload	Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.
	MessageClass	Returns or sets a String representing the message class for the Outlook item. Read/write.
	Mileage	Returns or sets a String representing the mileage for an item. Read/write.
	NoAging	Returns or sets a Boolean value that is True to not age the Outlook item. Read/write.
	Ordinal	Returns or sets a Long specifying the position in the view (ordinal) for the task. Read/write.
	OutlookInternalVersion	Returns a Long representing the build number of the Outlook application for an Outlook item. Read-only.
	OutlookVersion	Returns a String indicating the major and minor version number of the Outlook application for an Outlook item. Read-only.
	Owner	Returns or sets a String indicating the owner for the task.
	Ownership	Returns an OlTaskOwnership specifying the ownership state of the task. Read-only.
	Parent	Returns the parent Object of the specified object. Read-only.
	PercentComplete	Returns or sets a Long indicating the percentage of the task completed at the current date and time. Read/write.
	PropertyAccessor	Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent TaskItem object. Read-only.
	Recipients	Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only.
	ReminderOverrideDefault	Returns or sets a Boolean value that is True if the reminder overrides the default reminder behavior for the item. Read/write.
	ReminderPlaySound	Returns or sets a Boolean value that is True if the reminder should play a sound when it occurs for this item. Read/write.
	ReminderSet	Returns or sets a Boolean value that is True if a reminder has been set for this item. Read/write.
	ReminderSoundFile	Returns or sets a String indicating the path and file name of the sound file to play when the reminder occurs for the Outlook item. Read/write.
	ReminderTime	Returns or sets a Date indicating the date and time at which the reminder should occur for the specified item. Read/write.
	ResponseState	Returns an OlTaskResponse constant indicating the overall status of the response to the specified task request. Read-only.
	Role	Returns or sets a String containing the free-form text string associating the owner of a task with a role for the task. Read/write.
	Saved	Returns a Boolean value that is True if the Outlook item has not been modified since the last save. Read-only.
	SchedulePlusPriority	Returns or sets a String representing the Microsoft Schedule+ priority for the task. Read/write.
	SendUsingAccount	Returns or sets an Account object that represents the account under which the TaskItem object is to be sent. Read/write.
	Sensitivity	Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write.
	Session	Returns the NameSpace object for the current session. Read-only.
	Size	Returns a Long indicating the size (in bytes) of the Outlook item. Read-only.
	StartDate	Returns or sets a Date indicating the start date for the task. Read/write.
	Status	Returns or sets an OlTaskStatus constant specifying the status for the task. Corresponds to the Status field of a TaskItem . Read/write.
	StatusOnCompletionRecipients	Returns or sets a semicolon-delimited String of display names for recipients who will receive status upon completion of the task. Read/write.
	StatusUpdateRecipients	Returns a semicolon-delimited String of display names for recipients who receive status updates for the task. Read-write.
	Subject	Returns or sets a String indicating the subject for the Outlook item. Read/write.
	TeamTask	Returns a Boolean that indicates True if the task is a team task. Read/write.
	ToDoTaskOrdinal	Returns or sets a Date value that represents the ordinal value of the task for the TaskItem. Read/write.
	TotalWork	Returns or sets a Long indicating the total work for the task. Read/write.
	UnRead	Returns or sets a Boolean value that is True if the Outlook item has not been opened (read). Read/write.
	UserProperties	Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.

Events

	Name	Description
	AttachmentAdd	Occurs when an attachment has been added to an instance of the parent object.
	AttachmentRead	Occurs when an attachment in an instance of the parent object has been opened for reading.
	AttachmentRemove	Occurs when an attachment has been removed from an instance of the parent object.
	BeforeAttachmentAdd	Occurs before an attachment is added to an instance of the parent object.
	BeforeAttachmentPreview	Occurs before an attachment associated with an instance of the parent object is previewed.
	BeforeAttachmentRead	Occurs before an attachment associated with an instance of the parent object is read from the file system, an attachment stream, or an Attachment object.
	BeforeAttachmentSave	Occurs just before an attachment is saved.
	BeforeAttachmentWriteToTempFile	Occurs before an attachment associated with an instance of the parent object is written to a temporary file.
	BeforeAutoSave	Occurs before the item is automatically saved by Outlook.
	BeforeCheckNames	Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object).
	BeforeDelete	Occurs before an item (which is an instance of the parent object) is deleted.
	Close	Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.
	CustomAction	Occurs when a custom action of an item (which is an instance of the parent object) executes.
	CustomPropertyChange	Occurs when a custom property of an item (which is an instance of the parent object) is changed.
	Forward	Occurs when the user selects the Forward action for an item (which is an instance of the parent object).
	Open	Occurs when an instance of the parent object is being opened in an Inspector.
	PropertyChange	Occurs when an explicit built-in property (for example, Subject) of an instance of the parent object is changed.
	Read	Occurs when an instance of the parent object is opened for editing by the user.
	Reply	Occurs when the user selects the Reply action for an item (which is an instance of the parent object).
	ReplyAll	Occurs when the user selects the ReplyAll action for an item (which is an instance of the parent object).
	Send	Occurs when the user selects the Send action for an item, or when the Send method is called for the item, which is an instance of the parent object.
	Unload	Occurs before an Outlook item is unloaded from memory, either programmatically or by user action.
	Write	Occurs when an instance of the parent object is saved, either explicitly (for example, using the Save or SaveAs methods) or implicitly (for example, in response to a prompt when closing the item's inspector).