RDOSelectNamesDialog object

 

IRDOSelectNamesDialog represents the Outlook address book dialog, which can be shown modally to a select recipients or modelessly to browse the address entries.

 

Returned by:

RDOSession.GetSelectNamesDialog

 

The example below displays the contents of the Contacts common folder.

set Session = CreateObject("Redemption.RDOSession")
Session.MAPIOBJECT = Application.Session.MAPIOBJECT
set ABDialog = Session.GetSelectNamesDialog
ABDialog.ActiveRecipientSelector = olBCC
set Contacts = Session.GetDefaultFolder(olFolderContacts)
if (not (Contacts Is Nothing)) and (Contacts.ShowAsOutlookAB) Then
    ABDialog.InitialAddressList = Contacts.GetAddressList
End If
ABDialog.ShowOnlyInitialAddressList = True
if ABDialog.Display Then
    for each recip in ABDialog.Recipients
        Debug.Print recip.Name & ": " & recip.Address
    next
End If

 

Properties

Methods

Events

 

 

Derived from: IDispatch

Properties
ActiveRecipientSelector Returns or sets rdoMailRecipientType enum that determines the active edit box (to/CC/BCC) when the Select Names dialog opens.
  
AllowMultipleSelection Returns or sets a Boolean that determines whether more than one address entry can be selected at a time in the Select Names dialog. Read/write.
  
BccLabel Returns or sets a String for the text that appears on the Bcc command button on the Select Names dialog box. Read/write
  
Caption Returns or sets the string that determines the caption of the Select Names dialog box. Read/write
  
CcLabel Returns or sets a String for the text that appears on the Cc command button on the Select Names dialog box. Read/write
  
ForceResolution Returns or sets a Boolean that determines if Outlook must resolve all recipients in the object specified by Recipients collection before the user can click OK to accept the typed or selected recipients in the Select Names dialog box. Read/write.
  
InitialAddressList Returns or sets an RDOAddressList object that determines the initial address list to be displayed in the Select Names dialog box. Read/write
  
NumberOfRecipientSelectors Returns or sets the number of recipient edit boxes (each associated with a command button) displayed in the Select Names dialog box. Read/write
  
Recipients Returns an RDORecipients collection object that represents the recipients selected in the Select Names dialog, or sets a Recipients collection object that represents the initial recipients to be displayed in the Select Names dialog box. Read/write.
  
ShowOnlyInitialAddressList Returns or sets a Boolean that determines if the RDOAddressList represented by the InitialAddressList property is the only address list available in the drop-down list for Address Book in the Select Names dialog box. Read/write.
  
ToLabel Returns or sets a String for the text that appears on the To command button on the Select Names dialog box. Read/write
  

Methods
Display(Modal) Displays the Select Names dialog box.

Modal - boolean,. optional. Defaults to true if not specicied.
If true, the dialog box is displayed modally, and modallesly otherwise.
  
SetDefaultDisplayMode(defaultMode) Sets the default display mode for the Select Names dialog box, specifying its caption and button labels.
All the strings are set in the current system locale; this way the calling application does not have to explicitly set the captions.

defaultMode - one of the rdoDefaultSelectNamesDisplayMode enums.

olDefaultMail = 1
olDefaultMeeting = 2
olDefaultSharingRequest = 4
olDefaultTask = 3
olDefaultMembers = 5
olDefaultDelegates = 6
olDefaultSingleName = 7
olDefaultPickRooms = 8
  

Events:
OnClose