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: 12.1   12.2   12.3   12.4   12.5   13.0   13.1   13.2   13.3   13.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

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

💬 Ask a question or report a problem