Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4    Statistic  

Addressbook.multivalue.insertValue

Inserts a value and its label at the given index in a multivalue list.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Addressbook 3.1 Yes No Yes, macOS only No Yes

MBS( "Addressbook.multivalue.insertValue"; value; label; index )

Parameters

Parameter Description Example value
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


Addressbook.multivalue.indexForIdentifier   -   Addressbook.multivalue.labelAtIndex

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins