Edit

Share via


TaskItem Interface

Definition

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

public interface class TaskItem : Microsoft::Office::Interop::Outlook::_TaskItem, Microsoft::Office::Interop::Outlook::ItemEvents_10_Event
[System.Runtime.InteropServices.Guid("00063035-0000-0000-C000-000000000046")]
public interface TaskItem : Microsoft.Office.Interop.Outlook._TaskItem, Microsoft.Office.Interop.Outlook.ItemEvents_10_Event
Public Interface TaskItem
Implements _TaskItem, ItemEvents_10_Event
Derived
Attributes
Implements

Remarks

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _TaskItem. For information about the event members of the COM object, see ItemEvents_10_Event.

Use the CreateItem(OlItemType) method to create a TaskItem object that represents a new task.

Use Items(index), where index is the index number of a task or a value used to match the default property of a task, to return a single TaskItem object from a Tasks folder.

Properties

Actions

Returns an Actions collection that represents all the available actions for the item. Read-only.

(Inherited from _TaskItem)
ActualWork

Returns or sets an Integer (int in C#) value indicating the actual effort spent on the task. Read/write.

(Inherited from _TaskItem)
Application

Returns an Application object that represents the parent Outlook application for the object. Read-only.

(Inherited from _TaskItem)
Attachments

Returns an Attachments object that represents all the attachments for the specified item. Read-only.

(Inherited from _TaskItem)
AutoResolvedWinner

Returns a Boolean (bool in C#) that determines if the item is a winner of an automatic conflict resolution. Read-only.

(Inherited from _TaskItem)
BillingInformation

Returns or sets a String (string in C#) representing the billing information associated with the Outlook item. Read/write.

(Inherited from _TaskItem)
Body

Returns or sets a String (string in C#) representing the clear-text body of the Outlook item. Read/write.

(Inherited from _TaskItem)
CardData

Returns or sets a String (string in C#) representing the text of the card data for the task. Read/write.

(Inherited from _TaskItem)
Categories

Returns or sets a String (string in C#) representing the categories assigned to the Outlook item. Read/write.

(Inherited from _TaskItem)
Class

Returns an OlObjectClass constant indicating the object's class. Read-only.

(Inherited from _TaskItem)
Companies

Returns or sets a String (string in C#) representing the names of the companies associated with the Outlook item. Read/write.

(Inherited from _TaskItem)
Complete

Returns a Boolean (bool in C#) that is True if the task is completed. Read/write.

(Inherited from _TaskItem)
Conflicts

Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.

(Inherited from _TaskItem)
ContactNames

Returns or sets a String (string in C#) representing the contact names associated with the Outlook item. Read/write.

(Inherited from _TaskItem)
Contacts

This object, member, or enumeration is deprecated and is not intended to be used in your code.

(Inherited from _TaskItem)
ConversationID

Returns a String (string in C#) that uniquely identifies a Conversation object that the TaskItem object belongs to. Read-only.

(Inherited from _TaskItem)
ConversationIndex

Returns a String (string in C#) representing the index of the conversation thread of the Outlook item. Read-only.

(Inherited from _TaskItem)
ConversationTopic

Returns a String (string in C#) representing the topic of the conversation thread of the Outlook item. Read-only.

(Inherited from _TaskItem)
CreationTime

Returns a DateTime indicating the creation time for the Outlook item. Read-only.

(Inherited from _TaskItem)
DateCompleted

Returns or sets a DateTime indicating the completion date of the task. Read/write.

(Inherited from _TaskItem)
DelegationState

Returns an OlTaskDelegationState constant indicating the delegation state of the task. Read-only.

(Inherited from _TaskItem)
Delegator

Returns a String (string in C#) representing the display name of the delegator for the task. Read-only.

(Inherited from _TaskItem)
DownloadState

Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.

(Inherited from _TaskItem)
DueDate

Returns or sets a DateTime indicating the due date for the task. Read/write.

(Inherited from _TaskItem)
EntryID

Returns a String (string in C#) representing the unique Entry ID of the object. Read-only.

(Inherited from _TaskItem)
FormDescription

Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.

(Inherited from _TaskItem)
GetInspector

Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.

(Inherited from _TaskItem)
Importance

Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.

(Inherited from _TaskItem)
InternetCodepage

Returns or sets an Integer (int in C#) value that determines the Internet code page used by the item. Read/write.

(Inherited from _TaskItem)
IsConflict

Returns a Boolean (bool in C#) that determines if the item is in conflict. Read-only.

(Inherited from _TaskItem)
IsRecurring

Returns a Boolean (bool in C#) value that is True if the task is a recurring task. Read-only.

(Inherited from _TaskItem)
ItemProperties

Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.

(Inherited from _TaskItem)
LastModificationTime

Returns a DateTime specifying the date and time that the Outlook item was last modified. Read-only.

(Inherited from _TaskItem)
Links

This object, member, or enumeration is deprecated and is not intended to be used in your code.

(Inherited from _TaskItem)
MAPIOBJECT

This object, member, or enumeration is deprecated and is not intended to be used in your code.

(Inherited from _TaskItem)
MarkForDownload

Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.

(Inherited from _TaskItem)
MessageClass

Returns or sets a String (string in C#) representing the message class for the Outlook item. Read/write.

(Inherited from _TaskItem)
Mileage

Returns or sets a String (string in C#) representing the mileage for an item. Read/write.

(Inherited from _TaskItem)
NoAging

Returns or sets a Boolean (bool in C#) value that is True to not age the Outlook item. Read/write.

(Inherited from _TaskItem)
Ordinal

Returns or sets an Integer (int in C#) value specifying the position in the view (ordinal) for the task. Read/write.

(Inherited from _TaskItem)
OutlookInternalVersion

Returns an Integer (int in C#) value representing the build number of the Outlook application for an Outlook item. Read-only.

(Inherited from _TaskItem)
OutlookVersion

Returns a String (string in C#) indicating the major and minor version number of the Outlook application for an Outlook item. Read-only.

(Inherited from _TaskItem)
Owner

Returns or sets a String (string in C#) indicating the owner for the task.

(Inherited from _TaskItem)
Ownership

Returns an OlTaskOwnership specifying the ownership state of the task. Read-only.

(Inherited from _TaskItem)
Parent

Returns the parent Object of the specified object. Read-only.

(Inherited from _TaskItem)
PercentComplete

Returns or sets an Integer (int in C#) value indicating the percentage of the task completed at the current date and time. Read/write.

(Inherited from _TaskItem)
PropertyAccessor

Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent TaskItem object. Read-only.

(Inherited from _TaskItem)
Recipients

Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only.

(Inherited from _TaskItem)
ReminderOverrideDefault

Returns or sets a Boolean (bool in C#) value that is True if the reminder overrides the default reminder behavior for the item. Read/write.

(Inherited from _TaskItem)
ReminderPlaySound

Returns or sets a Boolean (bool in C#) value that is True if the reminder should play a sound when it occurs for this item. Read/write.

(Inherited from _TaskItem)
ReminderSet

Returns or sets a Boolean (bool in C#) value that is True if a reminder has been set for this item. Read/write.

(Inherited from _TaskItem)
ReminderSoundFile

Returns or sets a String (string in C#) indicating the path and file name of the sound file to play when the reminder occurs for the Outlook item. Read/write.

(Inherited from _TaskItem)
ReminderTime

Returns or sets a DateTime indicating the date and time at which the reminder should occur for the specified item. Read/write.

(Inherited from _TaskItem)
ResponseState

Returns an OlTaskResponse constant indicating the overall status of the response to the specified task request. Read-only.

(Inherited from _TaskItem)
Role

Returns or sets a String (string in C#) containing the free-form text string associating the owner of a task with a role for the task. Read/write.

(Inherited from _TaskItem)
RTFBody

Returns or sets a byte array that represents the body of the Microsoft Outlook item in Rich Text Format. Read/write.

(Inherited from _TaskItem)
Saved

Returns a Boolean (bool in C#) value that is True if the Outlook item has not been modified since the last save. Read-only.

(Inherited from _TaskItem)
SchedulePlusPriority

Returns or sets a String (string in C#) representing the Microsoft Schedule+ priority for the task. Read/write.

(Inherited from _TaskItem)
SendUsingAccount

Returns or sets an Account object that represents the account under which the TaskItem object is to be sent. Read/write.

(Inherited from _TaskItem)
Sensitivity

Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write.

(Inherited from _TaskItem)
Session

Returns the NameSpace object for the current session. Read-only.

(Inherited from _TaskItem)
Size

Returns an Integer (int in C#) value indicating the size (in bytes) of the Outlook item. Read-only.

(Inherited from _TaskItem)
StartDate

Returns or sets a DateTime indicating the start date for the task. Read/write.

(Inherited from _TaskItem)
Status

Returns or sets an OlTaskStatus constant specifying the status for the task. Corresponds to the Status field of a TaskItem. Read/write.

(Inherited from _TaskItem)
StatusOnCompletionRecipients

Returns or sets a semicolon-delimited String (string in C#) of display names for recipients who will receive status upon completion of the task. Read/write.

(Inherited from _TaskItem)
StatusUpdateRecipients

Returns a semicolon-delimited String (string in C#) of display names for recipients who receive status updates for the task. Read/write.

(Inherited from _TaskItem)
Subject

Returns or sets a String (string in C#) indicating the subject for the Outlook item. Read/write.

(Inherited from _TaskItem)
TeamTask

Returns a Boolean (bool in C#) that indicates True if the task is a team task. Read/write.

(Inherited from _TaskItem)
ToDoTaskOrdinal

Returns or sets a DateTime value that represents the ordinal value of the task for the TaskItem. Read/write.

(Inherited from _TaskItem)
TotalWork

Returns or sets an Integer (int in C#) value indicating the total work for the task. Read/write.

(Inherited from _TaskItem)
UnRead

Returns or sets a Boolean (bool in C#) value that is True if the Outlook item has not been opened (read). Read/write.

(Inherited from _TaskItem)
UserProperties

Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.

(Inherited from _TaskItem)

Methods

Assign()

Assigns a task and returns a TaskItem object that represents it.

(Inherited from _TaskItem)
CancelResponseState()

Resets an unsent response to a task request back to a simple task.

(Inherited from _TaskItem)
ClearRecurrencePattern()

Removes the recurrence settings and restores the single-occurrence state for an appointment or task.

(Inherited from _TaskItem)
Close(OlInspectorClose)

Closes and optionally saves changes to the Outlook item.

(Inherited from _TaskItem)
Copy()

Creates another instance of an object.

(Inherited from _TaskItem)
Delete()

Removes the item from the folder that contains the item.

(Inherited from _TaskItem)
Display(Object)

Displays a new Inspector object for the item.

(Inherited from _TaskItem)
GetConversation()

Obtains a Conversation object that represents the conversation to which this item belongs.

(Inherited from _TaskItem)
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.

(Inherited from _TaskItem)
MarkComplete()

Marks the task as completed.

(Inherited from _TaskItem)
Move(MAPIFolder)

Moves a Microsoft Outlook item to a new folder.

(Inherited from _TaskItem)
PrintOut()

Prints the Outlook item using all default settings. The PrintOut method is the only Outlook method that can be used for printing.

(Inherited from _TaskItem)
Respond(OlTaskResponse, Object, Object)

Responds to a task request.

(Inherited from _TaskItem)
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.

(Inherited from _TaskItem)
SaveAs(String, Object)

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.

(Inherited from _TaskItem)
ShowCategoriesDialog()

Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.

(Inherited from _TaskItem)
SkipRecurrence()

Clears the current instance of a recurring task and sets the recurrence to the next instance of that task.

(Inherited from _TaskItem)
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.

(Inherited from _TaskItem)

Events

AfterWrite

Occurs after Microsoft Outlook has saved the item.

(Inherited from ItemEvents_10_Event)
AttachmentAdd

Occurs when an attachment has been added to an instance of the parent object.

(Inherited from ItemEvents_10_Event)
AttachmentRead

Occurs when an attachment in an instance of the parent object has been opened for reading.

(Inherited from ItemEvents_10_Event)
AttachmentRemove

Occurs when an attachment has been removed from an instance of the parent object.

(Inherited from ItemEvents_10_Event)
BeforeAttachmentAdd

Occurs before an attachment is added to an instance of the parent object.

(Inherited from ItemEvents_10_Event)
BeforeAttachmentPreview

Occurs before an attachment associated with an instance of the parent object is previewed.

(Inherited from ItemEvents_10_Event)
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.

(Inherited from ItemEvents_10_Event)
BeforeAttachmentSave

Occurs just before an attachment is saved.

(Inherited from ItemEvents_10_Event)
BeforeAttachmentWriteToTempFile

Occurs before an attachment associated with an instance of the parent object is written to a temporary file.

(Inherited from ItemEvents_10_Event)
BeforeAutoSave

Occurs before the item is automatically saved by Outlook.

(Inherited from ItemEvents_10_Event)
BeforeCheckNames

Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object).

(Inherited from ItemEvents_10_Event)
BeforeDelete

Occurs before an item (which is an instance of the parent object) is deleted.

(Inherited from ItemEvents_10_Event)
BeforeRead

Occurs before Microsoft Outlook begins to read the properties for the item.

(Inherited from ItemEvents_10_Event)
Close

Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.

(Inherited from ItemEvents_10_Event)
CustomAction

Occurs when a custom action of an item (which is an instance of the parent object) executes.

(Inherited from ItemEvents_10_Event)
CustomPropertyChange

Occurs when a custom property of an item (which is an instance of the parent object) is changed.

(Inherited from ItemEvents_10_Event)
Forward

Occurs when the user selects the Forward action for an item (which is an instance of the parent object).

(Inherited from ItemEvents_10_Event)
Open

Occurs when an instance of the parent object is being opened in an Inspector.

(Inherited from ItemEvents_10_Event)
PropertyChange

Occurs when an explicit built-in property of an instance of the parent object is changed.

(Inherited from ItemEvents_10_Event)
Read

Occurs when an instance of the parent object is opened for editing by the user.

(Inherited from ItemEvents_10_Event)
ReadComplete

Occurs when Outlook has completed reading the properties of the item.

(Inherited from ItemEvents_10_Event)
Reply

Occurs when the user selects the Reply action for an item (which is an instance of the parent object).

(Inherited from ItemEvents_10_Event)
ReplyAll

Occurs when the user selects the ReplyAll action for an item (which is an instance of the parent object).

(Inherited from ItemEvents_10_Event)
Send

Occurs when the user selects the Send action for an item (which is an instance of the parent object).

(Inherited from ItemEvents_10_Event)
Unload

Occurs before an Outlook item is unloaded from memory, either programmatically or by user action.

(Inherited from ItemEvents_10_Event)
Write

Occurs when an instance of the parent object is saved, either explicitly or implicitly (for example, in response to a prompt when closing the item's inspector).

(Inherited from ItemEvents_10_Event)

Applies to