Webmasters, gagnez de l'argent en affichant des bannières contextuelles Oxado
SourceForge.net Logo
Support This Project Free Downloads
WABAccess Project
Welcome ! [ Home ]  ·  [ Downloads ]  ·  [ Forums ]  ·  [ News ]  ·  [ Documentations ]  
[ Home ]

[ Documentations ]

ShowAddress Method


The ShowAddress method display a dialog box that allows the user to select Contact or Distribution List from the WAB. The selections are returned in a Recipients collection object.

Syntax :

Set objRecipients = objSession.ShowAddress( [Title] [, selectOnly] [, oneAddress] [, forceResolution] [, recipLists] [, toLabel] [, ccLabel] [, bccLabel] [, parentWindow] [, selectedRecipients] )

Applies To : Session

Parameters :
Name Type In / Out Required / Optional Description
Title String In Optional The title of the dialog box, by default the title is an empty string.
selectOnly Boolean In Optional If True disables the creation of Contact in the dialog box.
If False (the default), the user can create new contact in the dialog box.
oneAddress Boolean In Optional If True the user can select only one recipient.
If False (the default), the user can select multiple recipients.
forceResolution Boolean In Optional If True (the default), causes all names to be resolved after the address dialog box is closed. If there are ambiguous entries resulting from the name resolution process, a dialog box is displayed to prompt the user for help in resolving them.
recipLists Long In Optional The number of recipient list boxes to display in the dialog box :
0 Displays no list boxes. The user can interact with the dialog box but no recipients are returned by this method.
1 Displays one list box for recipientTO recipients (the default).
2 Displays two list boxes for recipientTO and recipientCC recipients.
3 Displays three list boxes for recipientTO, recipientCC and recipientBCC recipients.
toLabel String In Optional The caption for the button associated with the first recipient list box. Ignored if recipLists is less than 1. If omitted, the default value To: is displayed.
ccLabel String In Optional The caption for the button associated with the second recipient list box. Ignored if recipLists is less than 2. If omitted, the default value Cc: is displayed.
bccLabel String In Optional The caption for the button associated with the third recipient list box. Ignored if recipLists is less than 3. If omitted, the default value Bcc: is displayed.
parentWindow Long In Optional Specifies the parent window handle for the dialog box. A value of zero (the default) specifies that the dialog box should be application-modal. A value of 1 specifies that the currently active window is to be used as the parent window.
selectedRecipients Variant In Optional A Recipients collection of preselected contact or distribution list.
Return Value :

On successful return, contains a Recipients collection object.

Details :

Each recipient in the Recipients collection has a property PR_RECIPIENT_TYPE indicates the type of the recipient with a value of the enumRecipientType enumeration. If the user click on Cancel button the method raise the MAPI_E_USER_CANCEL error.

Example :
Dim objMyRecipients, objSession

Set objMyRecipients = objSession.ShowAddress()

WABAccess