Platforms to show: All Mac Windows Linux Cross-Platform

Back to ABPersonMBS class.

ABPersonMBS.Constructor

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Creates a new ABPersonMBS object.

See also:

ABPersonMBS.Constructor(addressBook as ABAddressBookMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 11.2 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Creates a new ABPersonMBS object in the given addressbook.

Available in Mac OS X 10.5 or newer.

See also:

ABPersonMBS.Constructor(vCardData as Memoryblock)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Create a person from a vCard

Handle is 0 on failure after constructor finished.
(e.g. because of invalid vCard data)

This gives a temporary ABPersonMBS object which is only useful in the same method.
At least we observed problems and crashes when this person is stored in a property of a window and used later.

See also:

ABPersonMBS.EditInAddressbook as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Opens addressbook entry in the addressbook for editing.

Returns true on success and false on failure.

ABPersonMBS.image as NSImageMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property Addressbook MBS MacCocoa Plugin 7.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Synchronously returns data containing an image for this person.
Example
dim a as new ABAddressBookMBS
dim p as ABPersonMBS = a.owner

Backdrop=p.image.CopyPictureWithMask

Only does local file system searches.
Raises an exception if no image exists.

Convenience function which calls imageData and converts data to and from NSImage.
(Read and Write computed property)

ABPersonMBS.imageData as Memoryblock

Type Topic Plugin Version macOS Windows Linux iOS Targets
property Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Synchronously returns data containing an image for this person.
Example
dim a as new ABAddressBookMBS
dim owner as ABPersonMBS = a.owner
dim s as string = owner.imageData
dim p as Picture

p=JPEGStringToPictureMBS(s) // try jpeg
if p<>Nil then
Title="jpeg"
Backdrop=p
Return
end if

p=TIFFStringToPictureMBS(s) // try tiff
if p<>Nil then
Title="tiff"
Backdrop=p
Return
end if

Only does local file system searches. Data will be in an NSImage/QuickTime compatible format.
Raises an exception if no image exists.
(Read and Write computed property)

ABPersonMBS.linkedPeople as ABPersonMBS()

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns an array of all linked people, including this person.

Returns an array of only this person if this person is not linked.
Available in Mac OS X 10.8 and newer.

ABPersonMBS.parentGroups as ABGroupMBS()

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 11.2 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns an array of ABGroup this group belongs to.

Returns an empty array if this person doesn't belong to any groups.
Returns an empty array on any error.

ABPersonMBS.setImageData(data as Memoryblock) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Set the image of a person to data. data should be in an NSImage/QuickTime compatible format.

Pass "" to clear the image.

ABPersonMBS.ShowInAddressbook as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Shows addressbook entry in the addressbook.
Example
// open addressbook
dim a as new ABAddressBookMBS

// pick a person, in this case me
dim p as ABPersonMBS = a.owner

// show in AddressBook
call p.ShowInAddressbook

Returns true on success and false on failure.

Some examples using this method:

ABPersonMBS.vCardRepresentation as Memoryblock

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Addressbook MBS MacCocoa Plugin 7.1 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns the vCard representation of a person

Returns nil on any error.

Some examples using this method:

The items on this page are in the following plugins: MBS MacCocoa Plugin.


The biggest plugin in space...