<div class="meta" robots="noindex">

</div>

Class

# AddressBookContact

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

<div class="warning">

<div class="title">

Warning

</div>

This item was deprecated in version 2019r2. There is no replacement.

</div>

## Description

Holds a Contact record in a macOS Address Book.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                      | Type                                               | Read-Only | Shared |
|-----------------------------------------------------------|----------------------------------------------------|-----------|--------|
| `Addresses<addressbookcontact.addresses>`                 | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `AIMScreenNames<addressbookcontact.aimscreennames>`       | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `Birthday<addressbookcontact.birthday>`                   | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `CompanyName<addressbookcontact.companyname>`             | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `CreationDate<addressbookcontact.creationdate>`           | `Date</api/deprecated/date>`                       |           |        |
| `EmailAddresses<addressbookcontact.emailaddresses>`       | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `FirstName<addressbookcontact.firstname>`                 | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `HomePage<addressbookcontact.homepage>`                   | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `ICQNumbers<addressbookcontact.icqnumbers>`               | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `JabberScreenNames<addressbookcontact.jabberscreennames>` | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `JobTitle<addressbookcontact.jobtitle>`                   | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `LastName<addressbookcontact.lastname>`                   | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `MiddleName<addressbookcontact.middlename>`               | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `ModificationDate<addressbookcontact.modificationdate>`   | `Date</api/deprecated/date>`                       |           |        |
| `MSNScreenNames<addressbookcontact.msnscreennames>`       | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `Note<addressbookcontact.note>`                           | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `PhoneNumbers<addressbookcontact.phonenumbers>`           | `AddressBookData</api/deprecated/addressbookdata>` |           |        |
| `UniqueID<addressbookcontact.uniqueid>`                   | `String</api/data_types/string>`                   |           |        |
| `VCard<addressbookcontact.vcard>`                         | `String</api/data_types/string>`                   |           |        |
| `YahooScreenNames<addressbookcontact.yahooscreennames>`   | `AddressBookData</api/deprecated/addressbookdata>` |           |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                           | Parameters                                       | Returns                            | Shared |
|------------------------------------------------|--------------------------------------------------|------------------------------------|--------|
| `Constructor<addressbookcontact.constructor0>` | vcard As `String</api/data_types/string>`        |                                    |        |
| `RemoveValue<addressbookcontact.removevalue>`  | PropertyName As `String</api/data_types/string>` |                                    |        |
| `Value<addressbookcontact.value>`              | PropertyName As `String</api/data_types/string>` | `Variant</api/data_types/variant>` |        |

## Property descriptions

<div id="addressbookcontact.addresses">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.Addresses

**Addresses** As `AddressBookData</api/deprecated/addressbookdata>`

The Addresses entry.

<div id="addressbookcontact.aimscreennames">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.AIMScreenNames

**AIMScreenNames** As `AddressBookData</api/deprecated/addressbookdata>`

A contact's AIMScreenNames entry.

This property was [deprecated by Apple](https://developer.apple.com/documentation/addressbook/kabaiminstantproperty?language=objc).

<div id="addressbookcontact.birthday">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.Birthday

**Birthday** As `AddressBookData</api/deprecated/addressbookdata>`

Birthday entry.

<div id="addressbookcontact.companyname">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.CompanyName

**CompanyName** As `AddressBookData</api/deprecated/addressbookdata>`

The Company Name entry.

The following code saves the new company name.

``` xojo
Dim book As New AddressBook
book = System.AddressBook
book.CurrentUser.CompanyName = "Hewlett Packard"
If book.HasUnsavedChanges Then
  If book.save Then
    MsgBox("The AddressBook was saved!")
  End If
Else
  MsgBox("There were no unsaved changes!")
End If
```

<div id="addressbookcontact.creationdate">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.CreationDate

**CreationDate** As `Date</api/deprecated/date>`

Returns the creation date of the record.

<div id="addressbookcontact.emailaddresses">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.EmailAddresses

**EmailAddresses** As `AddressBookData</api/deprecated/addressbookdata>`

Email Addresses entries.

<div id="addressbookcontact.firstname">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.FirstName

**FirstName** As `AddressBookData</api/deprecated/addressbookdata>`

FirstName entry.

This code adds a new contact with first and last names.

``` xojo
Dim book As New AddressBook
Dim myContact As AddressBookContact
book = System.AddressBook
myContact = New AddressBookContact

myContact.FirstName = "Xena"
myContact.LastName = "Smith"

book.Add(myContact)

If book.HasUnsavedChanges Then
  If book.Save Then
    MsgBox("The AddressBook was saved!")
  End If
Else
  MsgBox("There were no unsaved changes!")
End If
```

<div id="addressbookcontact.homepage">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.HomePage

**HomePage** As `AddressBookData</api/deprecated/addressbookdata>`

Home page entry.

This property was deprecated by [Apple in Mac OS X 10.4](https://developer.apple.com/documentation/addressbook/kabhomepageproperty?language=objc).

<div id="addressbookcontact.icqnumbers">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.ICQNumbers

**ICQNumbers** As `AddressBookData</api/deprecated/addressbookdata>`

ICQNumbers entry.

This property was [deprecated by Apple](https://developer.apple.com/documentation/addressbook/kabicqinstantproperty?language=objc).

<div id="addressbookcontact.jabberscreennames">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.JabberScreenNames

**JabberScreenNames** As `AddressBookData</api/deprecated/addressbookdata>`

Jabber screen names entry.

This property was [deprecated by Apple](https://developer.apple.com/documentation/addressbook/kabjabberinstantproperty?language=objc).

<div id="addressbookcontact.jobtitle">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.JobTitle

**JobTitle** As `AddressBookData</api/deprecated/addressbookdata>`

Job title entry.

<div id="addressbookcontact.lastname">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.LastName

**LastName** As `AddressBookData</api/deprecated/addressbookdata>`

Last Name entry.

The following code adds the LastName field to a new contact.

``` xojo
Dim book As New AddressBook
Dim myContact As AddressBookContact
book = System.AddressBook
myContact = New AddressBookContact

myContact.FirstName = "Xena"
myContact.LastName = "Smith"

book.Add(myContact)

If book.HasUnsavedChanges Then
  If book.Save Then
    MsgBox("The AddressBook was saved!")
  End If
Else
  MsgBox("There were no unsaved changes!")
End If
```

<div id="addressbookcontact.middlename">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.MiddleName

**MiddleName** As `AddressBookData</api/deprecated/addressbookdata>`

Middle Name entry.

<div id="addressbookcontact.modificationdate">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.ModificationDate

**ModificationDate** As `Date</api/deprecated/date>`

Returns the last modification date of the record.

<div id="addressbookcontact.msnscreennames">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.MSNScreenNames

**MSNScreenNames** As `AddressBookData</api/deprecated/addressbookdata>`

MSN screen names entry.

This property was [deprecated by Apple](https://developer.apple.com/documentation/addressbook/kabmsninstantproperty?language=objc).

<div id="addressbookcontact.note">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.Note

**Note** As `AddressBookData</api/deprecated/addressbookdata>`

Note entry.

<div id="addressbookcontact.phonenumbers">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.PhoneNumbers

**PhoneNumbers** As `AddressBookData</api/deprecated/addressbookdata>`

Phone Numbers entries.

<div id="addressbookcontact.uniqueid">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.UniqueID

**UniqueID** As `String</api/data_types/string>`

Returns the unique ID corresponding to the record.

<div id="addressbookcontact.vcard">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.VCard

**VCard** As `String</api/data_types/string>`

VCard format of Address Book entry.

<div id="addressbookcontact.yahooscreennames">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.YahooScreenNames

**YahooScreenNames** As `AddressBookData</api/deprecated/addressbookdata>`

Yahoo screen names entry.

This property was [deprecated by Apple](https://developer.apple.com/documentation/addressbook/kabyahooinstantproperty?language=objc).

## Method descriptions

<div id="addressbookcontact.constructor0">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.Constructor

**Constructor**(vcard as `String</api/data_types/string>`)

<div class="note">

<div class="title">

Note

</div>

`Constructors</api/language/constructor>` are special methods called when you create an object with the `New</api/language/new>` keyword and pass in the parameters above.

</div>

Creates an <span class="title-ref">AddressBookContact</span>. If the optional *vcard* is passed, populates it with the data in the vcard.

This method gets the current user's email addresses. It uses the Count and Value methods of the `AddressBookData</api/deprecated/addressbookdata>` class to do so.

``` xojo
Dim Book As AddressBook
Dim myContact As AddressBookContact
book = System.AddressBook
myContact = Book.CurrentUser
For i As Integer = 0 To myContact.EmailAddresses.Count - 1
  ListBox1.AddRow(myContact.emailAddresses.Value(i))
Next
```

<div id="addressbookcontact.removevalue">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.RemoveValue

**RemoveValue**(PropertyName As `String</api/data_types/string>`)

Removes the value for the specified property.

<div id="addressbookcontact.value">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

AddressBookContact.Value

**Value**(PropertyName As `String</api/data_types/string>`) As `Variant</api/data_types/variant>`

Sets the value for the specified property as a `Variant</api/data_types/variant>`.

## Notes

The methods of the `AddressBookData</api/deprecated/addressbookdata>` class give you access to the labels, names, values, and other properties of <span class="title-ref">AddressBookContact</span> records. Use the Value method to get and set values.

## Sample code

This method gets the current user's email addresses. It uses the Count and Value methods of the `AddressBookData</api/deprecated/addressbookdata>` class to do so.

``` xojo
Dim Book As AddressBook
Dim myContact As AddressBookContact
book = System.AddressBook
myContact = book.CurrentUser
For i As Integer =0 To myContact.emailAddresses.Count - 1
  ListBox1.AddRow(myContact.emailAddresses.Value(i))
Next
```

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

The following method sets the value of the FirstName field.

``` xojo
Dim Book As AddressBook
Dim myContact As AddressBookContact
book = System.AddressBook
myContact = book.CurrentUser
myContact.FirstName = "Boris"
' or using AddressBookData.Value method
myContact.FirstName.Value = "Boris"
```

## Compatibility

All project types on all supported operating systems.

## See also

`AddressBookRecord</api/deprecated/addressbookrecord>` parent class; `AddressBook</api/deprecated/addressbook>`, `AddressBookAddress</api/deprecated/addressbookaddress>`, `AddressBookData</api/deprecated/addressbookdata>`, `AddressBookGroup</api/deprecated/addressbookgroup>`, `AddressBookRecord</api/deprecated/addressbookrecord>` classes.
