AddressBookData.Insert Method

Inserts NewValue identified by Label. Used to insert multi-value properties such as phone numbers, email addresses, physical addresses, and so forth.

Syntax

AddressBookData.Insert Index, Label, NewValue


Parameters

Index

Integer

Label

String

NewValue

Variant


The label should be any of these constants (or literals) defined on AddressBookData:

LabelHome="Home"

LabelWork="Work"

LabelHomeFax="Home Fax"

LabelWorkFax="Work Fax"

LabelOther="Other"

LabelPager="Pager"

LabelMain="Main"

For anything other than phone numbers, the only valid labels are LabelHome, LabelWork, and LabelOther. Passing anything else will raise a RuntimeException. The Message property of the exception will explain the valid labels.

If the property being assigned a value is a custom property or a property the REALbasic AddressBook implementation does not know about, it will pass in the label given and not manipulate it in any way.