DistListItem DistListItem DistListItem Interface

Definition

Represents a distribution list in a Contacts folder.

public interface class DistListItem : Microsoft::Office::Interop::Outlook::_DistListItem, Microsoft::Office::Interop::Outlook::ItemEvents_10_Event
[System.Runtime.InteropServices.Guid("00063081-0000-0000-C000-000000000046")]
public interface DistListItem : Microsoft.Office.Interop.Outlook._DistListItem, Microsoft.Office.Interop.Outlook.ItemEvents_10_Event
Public Interface DistListItem
Implements _DistListItem, 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 _DistListItem. For information about the event members of the COM object, see DistListItemClass.

A distribution list can contain multiple recipients and is used to send messages to everyone in the list.

Use the CreateItem(OlItemType) method to create a DistListItem object that represents a new distribution list.

Use Items(index), where index is the index number of an item in a contacts folder or a value used to match the default property of an item in the folder, to return a single DistListItem object from a contacts folder (that is, a folder whose default item type is olContactItem).

Properties

Actions Actions Actions

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

(Inherited from _DistListItem)

Application Application Application

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

(Inherited from _DistListItem)

Attachments Attachments Attachments

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

(Inherited from _DistListItem)

AutoResolvedWinner AutoResolvedWinner AutoResolvedWinner

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

(Inherited from _DistListItem)

BillingInformation BillingInformation BillingInformation

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

(Inherited from _DistListItem)

Body Body Body

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

(Inherited from _DistListItem)

Categories Categories Categories

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

(Inherited from _DistListItem)

CheckSum CheckSum CheckSum

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

(Inherited from _DistListItem)

Class Class Class

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

(Inherited from _DistListItem)

Companies Companies Companies

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

(Inherited from _DistListItem)

Conflicts Conflicts Conflicts

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

(Inherited from _DistListItem)

ConversationID ConversationID ConversationID

Returns a string that uniquely identifies a Conversation object that the DistListItem object belongs to. Read-only.

(Inherited from _DistListItem)

ConversationIndex ConversationIndex ConversationIndex

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

(Inherited from _DistListItem)

ConversationTopic ConversationTopic ConversationTopic

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

(Inherited from _DistListItem)

CreationTime CreationTime CreationTime

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

(Inherited from _DistListItem)

DLName DLName DLName

Returns or sets a String (string in C#) representing the display name of a distribution list. Read/write.

(Inherited from _DistListItem)

DownloadState DownloadState DownloadState

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

(Inherited from _DistListItem)

EntryID EntryID EntryID

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

(Inherited from _DistListItem)

FormDescription FormDescription FormDescription

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

(Inherited from _DistListItem)

GetInspector GetInspector GetInspector

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

(Inherited from _DistListItem)

Importance Importance Importance

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

(Inherited from _DistListItem)

IsConflict IsConflict IsConflict

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

(Inherited from _DistListItem)

IsMarkedAsTask IsMarkedAsTask IsMarkedAsTask

Returns a Boolean (bool in C#) value that indicates whether the DistListItem is marked as a task. Read-only.

(Inherited from _DistListItem)

ItemProperties ItemProperties ItemProperties

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

(Inherited from _DistListItem)

LastModificationTime LastModificationTime LastModificationTime

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

(Inherited from _DistListItem)

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

(Inherited from _DistListItem)

MAPIOBJECT MAPIOBJECT MAPIOBJECT

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

(Inherited from _DistListItem)

MarkForDownload MarkForDownload 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 _DistListItem)

MemberCount MemberCount MemberCount

Returns an Integer (int in C#) value indicating the number of members in a distribution list. Read-only.

(Inherited from _DistListItem)

Members Members Members

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

(Inherited from _DistListItem)

MessageClass MessageClass MessageClass

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

(Inherited from _DistListItem)

Mileage Mileage Mileage

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

(Inherited from _DistListItem)

NoAging NoAging NoAging

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

(Inherited from _DistListItem)

OneOffMembers OneOffMembers OneOffMembers

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

(Inherited from _DistListItem)

OutlookInternalVersion OutlookInternalVersion OutlookInternalVersion

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

(Inherited from _DistListItem)

OutlookVersion OutlookVersion 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 _DistListItem)

Parent Parent Parent

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

(Inherited from _DistListItem)

PropertyAccessor PropertyAccessor PropertyAccessor

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

(Inherited from _DistListItem)

ReminderOverrideDefault ReminderOverrideDefault 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 _DistListItem)

ReminderPlaySound ReminderPlaySound 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 _DistListItem)

ReminderSet ReminderSet 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 _DistListItem)

ReminderSoundFile ReminderSoundFile 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 _DistListItem)

ReminderTime ReminderTime 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 _DistListItem)

RTFBody RTFBody RTFBody

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

(Inherited from _DistListItem)

Saved Saved 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 _DistListItem)

Sensitivity Sensitivity Sensitivity

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

(Inherited from _DistListItem)

Session Session Session

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

(Inherited from _DistListItem)

Size Size Size

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

(Inherited from _DistListItem)

Subject Subject Subject

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

(Inherited from _DistListItem)

TaskCompletedDate TaskCompletedDate TaskCompletedDate

Returns or sets a DateTime value that represents the completion date of the task for this DistListItem. Read/write.

(Inherited from _DistListItem)

TaskDueDate TaskDueDate TaskDueDate

Returns or sets a DateTime value that represents the due date of the task for this DistListItem. Read/write.

(Inherited from _DistListItem)

TaskStartDate TaskStartDate TaskStartDate

Returns or sets a DateTime value that represents the start date of the task for this DistListItem object. Read/write.

(Inherited from _DistListItem)

TaskSubject TaskSubject TaskSubject

Returns or sets a String (string in C#) value that represents the subject of the task for the DistListItem object. Read/write.

(Inherited from _DistListItem)

ToDoTaskOrdinal ToDoTaskOrdinal ToDoTaskOrdinal

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

(Inherited from _DistListItem)

UnRead UnRead 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 _DistListItem)

UserProperties UserProperties UserProperties

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

(Inherited from _DistListItem)

Methods

AddMember(Recipient) AddMember(Recipient) AddMember(Recipient)

Adds a new member to the specified distribution list. The distribution list contains Recipient objects that represent valid e-mail addresses.

(Inherited from _DistListItem)

AddMembers(Recipients) AddMembers(Recipients) AddMembers(Recipients)

Adds new members to a distribution list.

(Inherited from _DistListItem)

ClearTaskFlag() ClearTaskFlag() ClearTaskFlag()

Clears the DistListItem object as a task.

(Inherited from _DistListItem)

Close(OlInspectorClose) Close(OlInspectorClose) Close(OlInspectorClose)

Closes and optionally saves changes to the Outlook item.

(Inherited from _DistListItem)

Copy() Copy() Copy()

Creates another instance of an object.

(Inherited from _DistListItem)

Delete() Delete() Delete()

Removes the item from the folder that contains the item.

(Inherited from _DistListItem)

Display(Object) Display(Object) Display(Object)

Displays a new Inspector object for the item.

(Inherited from _DistListItem)

GetConversation() GetConversation() GetConversation()

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

(Inherited from _DistListItem)

GetMember(Int32) GetMember(Int32) GetMember(Int32)

Returns a Recipient object representing a member in a distribution list.

(Inherited from _DistListItem)

MarkAsTask(OlMarkInterval) MarkAsTask(OlMarkInterval) MarkAsTask(OlMarkInterval)

Marks a DistListItem object as a task and assigns a task interval for the object.

(Inherited from _DistListItem)

Move(MAPIFolder) Move(MAPIFolder) Move(MAPIFolder)

Moves a Microsoft Outlook item to a new folder.

(Inherited from _DistListItem)

PrintOut() PrintOut() 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 _DistListItem)

RemoveMember(Recipient) RemoveMember(Recipient) RemoveMember(Recipient)

Removes an individual member from a given distribution list.

(Inherited from _DistListItem)

RemoveMembers(Recipients) RemoveMembers(Recipients) RemoveMembers(Recipients)

Removes members from a distribution list.

(Inherited from _DistListItem)

Save() Save() 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 _DistListItem)

SaveAs(String, Object) SaveAs(String, Object) 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 _DistListItem)

ShowCategoriesDialog() ShowCategoriesDialog() ShowCategoriesDialog()

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

(Inherited from _DistListItem)

Events

AfterWrite AfterWrite AfterWrite

Occurs after Microsoft Outlook has saved the item.

(Inherited from ItemEvents_10_Event)

AttachmentAdd AttachmentAdd AttachmentAdd

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

(Inherited from ItemEvents_10_Event)

AttachmentRead AttachmentRead AttachmentRead

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

(Inherited from ItemEvents_10_Event)

AttachmentRemove AttachmentRemove AttachmentRemove

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

(Inherited from ItemEvents_10_Event)

BeforeAttachmentAdd BeforeAttachmentAdd BeforeAttachmentAdd

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

(Inherited from ItemEvents_10_Event)

BeforeAttachmentPreview BeforeAttachmentPreview BeforeAttachmentPreview

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

(Inherited from ItemEvents_10_Event)

BeforeAttachmentRead BeforeAttachmentRead 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 BeforeAttachmentSave BeforeAttachmentSave

Occurs just before an attachment is saved.

(Inherited from ItemEvents_10_Event)

BeforeAttachmentWriteToTempFile BeforeAttachmentWriteToTempFile 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 BeforeAutoSave BeforeAutoSave

Occurs before the item is automatically saved by Outlook.

(Inherited from ItemEvents_10_Event)

BeforeCheckNames BeforeCheckNames 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 BeforeDelete BeforeDelete

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

(Inherited from ItemEvents_10_Event)

BeforeRead BeforeRead BeforeRead

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

(Inherited from ItemEvents_10_Event)

Close Close 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 CustomAction CustomAction

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

(Inherited from ItemEvents_10_Event)

CustomPropertyChange CustomPropertyChange 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 Forward 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 Open Open

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

(Inherited from ItemEvents_10_Event)

PropertyChange PropertyChange PropertyChange

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

(Inherited from ItemEvents_10_Event)

Read Read Read

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

(Inherited from ItemEvents_10_Event)

ReadComplete ReadComplete ReadComplete

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

(Inherited from ItemEvents_10_Event)

Reply Reply 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 ReplyAll 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 Send 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 Unload Unload

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

(Inherited from ItemEvents_10_Event)

Write Write 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