Edit

Application.AddAddress method (Word)

  • Article

Adds an entry to the address book. Each entry has values for one or more tag IDs.

Syntax

expression.AddAddress (TagID, Value)

expression Required. A variable that represents an Application object.

Parameters

Name Required/Optional Data type Description
TagID Required String array The tag ID values for the new address entry. Each element in the array can contain one of the strings listed in the following table. Only the display name is required; the remaining entries are optional.
Value Required String array The values for the new address entry. Each element corresponds to an element in the TagID array. For more information, see the example.

Tag IDs

Tag ID Description
PR_DISPLAY_NAME Name displayed in the Address Book dialog box
PR_DISPLAY_NAME_PREFIX Title (for example, "Ms." or "Dr.")
PR_GIVEN_NAME First name
PR_SURNAME Last name
PR_STREET_ADDRESS Street address
PR_LOCALITY City or locality
PR_STATE_OR_PROVINCE State or province
PR_POSTAL_CODE Postal code
PR_COUNTRY Country/Region
PR_TITLE Job title
PR_COMPANY_NAME Company name
PR_DEPARTMENT_NAME Department name within the company
PR_OFFICE_LOCATION Office location
PR_PRIMARY_TELEPHONE_NUMBER Primary telephone number
PR_PRIMARY_FAX_NUMBER Primary fax number
PR_OFFICE_TELEPHONE_NUMBER Office telephone number
PR_OFFICE2_TELEPHONE_NUMBER Second office telephone number
PR_HOME_TELEPHONE_NUMBER Home telephone number
PR_CELLULAR_TELEPHONE_NUMBER Cellular telephone number
PR_BEEPER_TELEPHONE_NUMBER Beeper telephone number
PR_COMMENT Text included on the Notes tab for the address entry
PR_EMAIL_ADDRESS Electronic mail address
PR_ADDRTYPE Electronic mail address type
PR_OTHER_TELEPHONE_NUMBER Alternate telephone number (other than home or office)
PR_BUSINESS_FAX_NUMBER Business fax number
PR_HOME_FAX_NUMBER Home fax number
PR_RADIO_TELEPHONE_NUMBER Radio telephone number
PR_INITIALS Initials
PR_LOCATION Location, in the format buildingnumber/roomnumber (for example, 7/3007 represents room 3007 in building 7)
PR_CAR_TELEPHONE_NUMBER Car telephone number

Example

This example adds an entry to the address book.

Dim tagIDArray(0 To 3) As String 
Dim valueArray(0 To 3) As String 
 
tagIDArray(0) = "PR_DISPLAY_NAME" 
tagIDArray(1) = "PR_GIVEN_NAME" 
tagIDArray(2) = "PR_SURNAME" 
tagIDArray(3) = "PR_COMMENT" 
valueArray(0) = "Kim Buhler" 
valueArray(1) = "Kim" 
valueArray(2) = "Buhler" 
valueArray(3) = "This is a comment" 
 
Application.AddAddress TagID:=tagIDArray(), Value:=valueArray()

See also

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.