Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
10.1
10.2
10.3
10.4
10.5
11.0
11.1
11.2
11.3
11.4
Statistic
FMM
Blog
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
Created 18th August 2014, last changed 18th August 2014
Addressbook.multivalue.indexForLabel
-
Addressbook.multivalue.labelAtIndex
Feedback: Report problem or ask question.