DistListItem object (Outlook)

Represents a distribution list in a Contacts folder.

Remarks

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

Use the CreateItem 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).

Example

The following Microsoft Visual Basic for Applications (VBA) example creates and displays a new distribution list.

Set myItem = Application.CreateItem(olDistributionListItem) 
 
myItem.Display

The following Visual Basic for Applications example sets the current folder as the contacts folder and displays an existing distribution list named Project Team in the folder.

Set myNamespace = Application.GetNamespace("MAPI") 
 
Set myFolder = myNamespace.GetDefaultFolder(olFolderContacts) 
 
myFolder.Display 
 
Set myItem = myFolder.Items("Project Team") 
 
myItem.Display

Events

Name
AfterWrite
AttachmentAdd
AttachmentRead
AttachmentRemove
BeforeAttachmentAdd
BeforeAttachmentPreview
BeforeAttachmentRead
BeforeAttachmentSave
BeforeAttachmentWriteToTempFile
BeforeAutoSave
BeforeCheckNames
BeforeDelete
BeforeRead
Close
CustomAction
CustomPropertyChange
Forward
Open
PropertyChange
Read
ReadComplete
Reply
ReplyAll
Send
Unload
Write

Methods

Name
AddMember
AddMembers
ClearTaskFlag
Close
Copy
Delete
Display
GetConversation
GetMember
MarkAsTask
Move
PrintOut
RemoveMember
RemoveMembers
Save
SaveAs
ShowCategoriesDialog

Properties

Name
Actions
Application
Attachments
AutoResolvedWinner
BillingInformation
Body
Categories
Class
Companies
Conflicts
ConversationID
ConversationIndex
ConversationTopic
CreationTime
DLName
DownloadState
EntryID
FormDescription
GetInspector
Importance
IsConflict
IsMarkedAsTask
ItemProperties
LastModificationTime
MarkForDownload
MemberCount
MessageClass
Mileage
NoAging
OutlookInternalVersion
OutlookVersion
Parent
PropertyAccessor
ReminderOverrideDefault
ReminderPlaySound
ReminderSet
ReminderSoundFile
ReminderTime
RTFBody
Saved
Sensitivity
Session
Size
Subject
TaskCompletedDate
TaskDueDate
TaskStartDate
TaskSubject
ToDoTaskOrdinal
UnRead
UserProperties

See also

Outlook Object Model Reference

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.