Addressbook.multivalue.insertValue
Inserts a value and its label at the given index in a multivalue list.
Component |
Version |
macOS |
Windows |
Linux |
Server |
iOS SDK |
Addressbook
|
3.1 |
✅ Yes |
❌ No |
❌ No |
❌ No |
✅ Yes |
Deprecated
This function was deprecated. Use Contacts functions instead.
MBS( "Addressbook.multivalue.insertValue"; value; label; index )
More
MBS(
"Addressbook.multivalue.insertValue"; /* Inserts a value and its label at the given index in a multivalue list. */
$value; /* The value to add. */
$label; /* The label to associate with the value. */
$index) /* The index where the value will be inserted. */
Less
Parameters
Parameter |
Description |
Example |
value |
The value to add. |
$value |
label |
The label to associate with the value. |
$label |
index |
The index where the value will be inserted. |
$index |
Result
Returns identifier or error.
Description
Inserts a value and its label at the given index in a multivalue list.
Returns the identifier of the inserted value and label if they are added successfully; otherwise, empty result.
If either the value or the label is empty or if the index is out of bounds, this method returns an error.
Possible labels are:
kABHomePageLabel, kABEmailWorkLabel, kABEmailHomeLabel, kABAddressHomeLabel, kABAddressWorkLabel, kABAnniversaryLabel, kABFatherLabel, kABMotherLabel, kABParentLabel, kABBrotherLabel, kABSisterLabel, kABChildLabel, kABFriendLabel, kABSpouseLabel, kABPartnerLabel, kABAssistantLabel, kABManagerLabel, kABPhoneWorkLabel, kABPhoneHomeLabel, kABPhoneiPhoneLabel, kABPhoneMobileLabel, kABPhoneMainLabel, kABPhoneHomeFAXLabel, kABPhoneWorkFAXLabel, kABPhonePagerLabel, kABAIMWorkLabel, kABAIMHomeLabel, kABJabberWorkLabel, kABJabberHomeLabel, kABMSNWorkLabel, kABMSNHomeLabel, kABYahooWorkLabel, kABYahooHomeLabel, kABICQWorkLabel, kABICQHomeLabel, kABWorkLabel, kABHomeLabel, kABOtherLabel or kABMobileMeLabel.
See also
This function checks for a license.
Created 18th August 2014, last changed 18th August 2014
Addressbook.multivalue.indexForLabel
-
Addressbook.multivalue.labelAtIndex