MailItem Object Members

Outlook Developer Reference

Represents a mail message in an Inbox folder.

Methods

  Name Description
Bb176688.methods(en-us,office.12).gif AddBusinessCard Appends contact information based on the Electronic Business Card (EBC) associated with the specified ContactItem object to the MailItem object.
Bb176688.methods(en-us,office.12).gif ClearConversationIndex Clears the index of the conversation thread for the mail message.
Bb176688.methods(en-us,office.12).gif ClearTaskFlag Clears the MailItem object as a task.
Bb176688.methods(en-us,office.12).gif Close Closes and optionally saves changes to the Outlook item.
Bb176688.methods(en-us,office.12).gif Copy Creates another instance of an object.
Bb176688.methods(en-us,office.12).gif Delete Deletes an object from the collection.
Bb176688.methods(en-us,office.12).gif Display Displays a new Inspector object for the item.
Bb176688.methods(en-us,office.12).gif Forward Executes the Forward action for an item and returns the resulting copy as a MailItem object.
Bb176688.methods(en-us,office.12).gif MarkAsTask Marks a MailItem object as a task and assigns a task interval for the object.
Bb176688.methods(en-us,office.12).gif Move Moves a Microsoft Outlook item to a new folder.
Bb176688.methods(en-us,office.12).gif PrintOut Prints the Outlook item using all default settings.The PrintOut method is the only Outlook method that can be used for printing.
Bb176688.methods(en-us,office.12).gif Reply Creates a reply, pre-addressed to the original sender, from the original message.
Bb176688.methods(en-us,office.12).gif ReplyAll Creates a reply to all original recipients from the original message.
Bb176688.methods(en-us,office.12).gif 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.
Bb176688.methods(en-us,office.12).gif 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.
Bb176688.methods(en-us,office.12).gif Send Sends the e-mail message.
Bb176688.methods(en-us,office.12).gif ShowCategoriesDialog Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.

Properties

  Name Description
Bb176688.properties(en-us,office.12).gif Actions Returns an Actions collection that represents all the available actions for the item. Read-only.
Bb176688.properties(en-us,office.12).gif AlternateRecipientAllowed Returns True if the mail message can be forwarded. Read/write.
Bb176688.properties(en-us,office.12).gif Application Returns an Application object that represents the parent Outlook application for the object. Read-only.
Bb176688.properties(en-us,office.12).gif Attachments Returns an Attachments object that represents all the attachments for the specified item. Read-only.
Bb176688.properties(en-us,office.12).gif AutoForwarded A Boolean value that returns True if the item was automatically forwarded. Read/write.
Bb176688.properties(en-us,office.12).gif AutoResolvedWinner Returns a Boolean that determines if the item is a winner of an automatic conflict resolution. Read-only.
Bb176688.properties(en-us,office.12).gif BCC Returns a String representing the display list of blind carbon copy (BCC) names for a MailItem. Read/write.
Bb176688.properties(en-us,office.12).gif BillingInformation Returns or sets a String representing the billing information associated with the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif Body Returns or sets a String representing the clear-text body of the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif BodyFormat Returns or sets an OlBodyFormat constant indicating the format of the body text. Read/write.
Bb176688.properties(en-us,office.12).gif Categories Returns or sets a String representing the categories assigned to the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif CC Returns a String representing the display list of carbon copy (CC) names for a MailItem . Read/write.
Bb176688.properties(en-us,office.12).gif Class Returns an OlObjectClass constant indicating the object's class. Read-only.
Bb176688.properties(en-us,office.12).gif Companies Returns or sets a String representing the names of the companies associated with the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif Conflicts Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.
Bb176688.properties(en-us,office.12).gif ConversationIndex Returns a String representing the index of the conversation thread of the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif ConversationTopic Returns a String representing the topic of the conversation thread of the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif CreationTime Returns a Date indicating the creation time for the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif DeferredDeliveryTime Returns or sets a Date indicating the date and time the mail message is to be delivered. Read/write.
Bb176688.properties(en-us,office.12).gif DeleteAfterSubmit Returns or sets a Boolean value that is True if a copy of the mail message is not saved upon being sent, and False if a copy is saved. Read/write.
Bb176688.properties(en-us,office.12).gif DownloadState Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.
Bb176688.properties(en-us,office.12).gif EntryID Returns a String representing the unique Entry ID of the object. Read-only.
Bb176688.properties(en-us,office.12).gif ExpiryTime Returns or sets a Date indicating the date and time at which the item becomes invalid and can be deleted. Read/write.
Bb176688.properties(en-us,office.12).gif FlagRequest Returns or sets a String that indicates the requested action for a mail item. Read/write.
Bb176688.properties(en-us,office.12).gif FormDescription Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif GetInspector Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.
Bb176688.properties(en-us,office.12).gif HTMLBody Returns or sets a String representing the HTML body of the specified item. Read/write.
Bb176688.properties(en-us,office.12).gif Importance Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif InternetCodepage Returns or sets a Long that determines the Internet code page used by the item. Read/write.
Bb176688.properties(en-us,office.12).gif IsConflict Returns a Boolean that determines if the item is in conflict. Read-only.
Bb176688.properties(en-us,office.12).gif IsMarkedAsTask Returns a Boolean value that indicates whether the MailItem is marked as a task. Read-only.
Bb176688.properties(en-us,office.12).gif ItemProperties Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif LastModificationTime Returns a Date specifying the date and time that the Outlook item was last modified. Read-only.
Bb176688.properties(en-us,office.12).gif Links Returns a Links collection that represents the contacts to which the item is linked. Read-only.
Bb176688.properties(en-us,office.12).gif MarkForDownload Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.
Bb176688.properties(en-us,office.12).gif MessageClass Returns or sets a String representing the message class for the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif Mileage Returns or sets a String representing the mileage for an item. Read/write.
Bb176688.properties(en-us,office.12).gif NoAging Returns or sets a Boolean value that is True to not age the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif OriginatorDeliveryReportRequested Returns or sets a Boolean value that determines whether the originator of the meeting item or mail message will receive a delivery report. Read/write.
Bb176688.properties(en-us,office.12).gif OutlookInternalVersion Returns a Long representing the build number of the Outlook application for an Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif OutlookVersion Returns a String indicating the major and minor version number of the Outlook application for an Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif Parent Returns the parent Object of the specified object. Read-only.
Bb176688.properties(en-us,office.12).gif Permission Sets or returns an OlPermission constant that determines the permissions the recipients will have on the e-mail item. Read/write.
Bb176688.properties(en-us,office.12).gif PermissionService Sets or returns an OlPermissionService constant that determines the permission service that will be used when sending a message protected by Information Rights Management (IRM). Read/write.
Bb176688.properties(en-us,office.12).gif PropertyAccessor Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent MailItem object. Read-only.
Bb176688.properties(en-us,office.12).gif ReadReceiptRequested Returns a Boolean value that indicates True if a read receipt has been requested by the sender.
Bb176688.properties(en-us,office.12).gif ReceivedByEntryID Returns a String representing the EntryID for the true recipient as set by the transport provider delivering the mail message. Read-only.
Bb176688.properties(en-us,office.12).gif ReceivedByName Returns a String representing the display name of the true recipient for the mail message. Read-only.
Bb176688.properties(en-us,office.12).gif ReceivedOnBehalfOfEntryID Returns a String representing the EntryID of the user delegated to represent the recipient for the mail message. Read-only.
Bb176688.properties(en-us,office.12).gif ReceivedOnBehalfOfName Returns a String representing the display name of the user delegated to represent the recipient for the mail message. Read-only.
Bb176688.properties(en-us,office.12).gif ReceivedTime Returns a Date indicating the date and time at which the item was received. Read-only.
Bb176688.properties(en-us,office.12).gif RecipientReassignmentProhibited Returns a Boolean that indicates True if the recipient cannot forward the mail message. Read/write.
Bb176688.properties(en-us,office.12).gif Recipients Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif ReminderOverrideDefault Returns or sets a Boolean value that is True if the reminder overrides the default reminder behavior for the item. Read/write.
Bb176688.properties(en-us,office.12).gif 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.
Bb176688.properties(en-us,office.12).gif ReminderSet Returns or sets a Boolean value that is True if a reminder has been set for this item. Read/write.
Bb176688.properties(en-us,office.12).gif 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.
Bb176688.properties(en-us,office.12).gif ReminderTime Returns or sets a Date indicating the date and time at which the reminder should occur for the specified item. Read/write.
Bb176688.properties(en-us,office.12).gif RemoteStatus Returns or sets an OlRemoteStatus constant specifying the remote status of the mail message. Read/write.
Bb176688.properties(en-us,office.12).gif ReplyRecipientNames Returns a semicolon-delimited String list of reply recipients for the mail message. Read-only.
Bb176688.properties(en-us,office.12).gif ReplyRecipients Returns a Recipients collection that represents all the reply recipient objects for the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif Saved Returns a Boolean value that is True if the Outlook item has not been modified since the last save. Read-only.
Bb176688.properties(en-us,office.12).gif SaveSentMessageFolder Returns or sets a Folder object that represents the folder in which a copy of the e-mail message will be saved after being sent. Read/write.
Bb176688.properties(en-us,office.12).gif SenderEmailAddress Returns a String that represents the e-mail address of the sender of the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif SenderEmailType Returns a String that represents the type of entry for the e-mail address of the sender of the Outlook item, such as 'SMTP' for Internet address, 'EX' for a Microsoft Exchange server address, etc. Read-only.
Bb176688.properties(en-us,office.12).gif SenderName Returns a String indicating the display name of the sender for the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif SendUsingAccount Returns or sets an Account object that represents the account under which the MailItem is to be sent. Read/write.
Bb176688.properties(en-us,office.12).gif Sensitivity Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif Sent Returns a Boolean value that indicates if a message has been sent. Read-only.
Bb176688.properties(en-us,office.12).gif SentOn Returns a Date indicating the date and time on which the Outlook item was sent. Read-only.
Bb176688.properties(en-us,office.12).gif SentOnBehalfOfName Returns a String indicating the display name for the intended sender of the mail message. Read/write.
Bb176688.properties(en-us,office.12).gif Session Returns the NameSpace object for the current session. Read-only.
Bb176688.properties(en-us,office.12).gif Size Returns a Long indicating the size (in bytes) of the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif Subject Returns or sets a String indicating the subject for the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif Submitted Returns a Boolean value that is True if the item has been submitted. Read-only.
Bb176688.properties(en-us,office.12).gif TaskCompletedDate Returns or sets a Date value that represents the completion date of the task for this MailItem. Read/write.
Bb176688.properties(en-us,office.12).gif TaskDueDate Returns or sets a Date value that represents the due date of the task for this MailItem. Read/write.
Bb176688.properties(en-us,office.12).gif TaskStartDate Returns or sets a Date value that represents the start date of the task for this MailItem object. Read/write.
Bb176688.properties(en-us,office.12).gif TaskSubject Returns or sets a String value that represents the subject of the task for the MailItem object. Read/write.
Bb176688.properties(en-us,office.12).gif To Returns or sets a semicolon-delimited String list of display names for the To recipients for the Outlook item. Read/write.
Bb176688.properties(en-us,office.12).gif ToDoTaskOrdinal Returns or sets a Date value that represents the ordinal value of the task for the MailItem. Read/write.
Bb176688.properties(en-us,office.12).gif UnRead Returns or sets a Boolean value that is True if the Outlook item has not been opened (read). Read/write.
Bb176688.properties(en-us,office.12).gif UserProperties Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.
Bb176688.properties(en-us,office.12).gif VotingOptions Returns or sets a String specifying a delimited string containing the voting options for the mail message. Read/write.
Bb176688.properties(en-us,office.12).gif VotingResponse Returns or sets a String specifying the voting response for the mail message. Read/write.

Events

  Name Description
Bb176688.events(en-us,office.12).gif AttachmentAdd Occurs when an attachment has been added to an instance of the parent object.
Bb176688.events(en-us,office.12).gif AttachmentRead Occurs when an attachment in an instance of the parent object has been opened for reading.
Bb176688.events(en-us,office.12).gif AttachmentRemove Occurs when an attachment has been removed from an instance of the parent object.
Bb176688.events(en-us,office.12).gif BeforeAttachmentAdd Occurs before an attachment is added to an instance of the parent object.
Bb176688.events(en-us,office.12).gif BeforeAttachmentPreview Occurs before an attachment associated with an instance of the parent object is previewed.
Bb176688.events(en-us,office.12).gif 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.
Bb176688.events(en-us,office.12).gif BeforeAttachmentSave Occurs just before an attachment is saved.
Bb176688.events(en-us,office.12).gif BeforeAttachmentWriteToTempFile Occurs before an attachment associated with an instance of the parent object is written to a temporary file.
Bb176688.events(en-us,office.12).gif BeforeAutoSave Occurs before the item is automatically saved by Outlook.
Bb176688.events(en-us,office.12).gif BeforeCheckNames Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object).
Bb176688.events(en-us,office.12).gif BeforeDelete Occurs before an item (which is an instance of the parent object) is deleted.
Bb176688.events(en-us,office.12).gif Close Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.
Bb176688.events(en-us,office.12).gif CustomAction Occurs when a custom action of an item (which is an instance of the parent object) executes.
Bb176688.events(en-us,office.12).gif CustomPropertyChange Occurs when a custom property of an item (which is an instance of the parent object) is changed.
Bb176688.events(en-us,office.12).gif Forward Occurs when the user selects the Forward action for an item, or when the Forward method is called for the item, which is an instance of the parent object.
Bb176688.events(en-us,office.12).gif Open Occurs when an instance of the parent object is being opened in an Inspector.
Bb176688.events(en-us,office.12).gif PropertyChange Occurs when an explicit built-in property (for example, Subject) of an instance of the parent object is changed.
Bb176688.events(en-us,office.12).gif Read Occurs when an instance of the parent object is opened for editing by the user.
Bb176688.events(en-us,office.12).gif Reply Occurs when the user selects the Reply action for an item, or when the Reply method is called for the item, which is an instance of the parent object.
Bb176688.events(en-us,office.12).gif ReplyAll Occurs when the user selects the ReplyAll action for an item, or when the ReplyAll method is called for the item, which is an instance of the parent object.
Bb176688.events(en-us,office.12).gif 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.
Bb176688.events(en-us,office.12).gif Unload Occurs before an Outlook item is unloaded from memory, either programmatically or by user action.
Bb176688.events(en-us,office.12).gif 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).