
CHAPTER 10: Scripting Access to XMP Metadata XMPScript object reference 293
separateArrayItems()
XMPUtils.separateArrayItems(xmpObj, schemaNS, arrayName, arrayOptions, concatString)
xmpObj
The XMPMeta object containing the array.
schemaNS
The namespace URI string. See “Schema namespace string constants” on
page 262.
arrayName
The array property name string. Can be a general path expression. Each item in
the array must be a simple string value.
arrayOptions
Option flags that control how the array property is updated from the separated
string. A logical OR of these bit-flag constants:
X XMPConst.APPEND_ALL_PROPERTIES — Include both internal and external
properties. By default, copies only external properties. This applies only to
top-level properties.
X XMPConst.APPEND_REPLACE_OLD_VALUES — Replace the values of existing
properties with the value from the source object. By default, existing values
are retained. This applies to properties at all levels of hierarchy.
X XMPConst.APPEND_DELETE_EMPTY_VALUES — Delete properties if the new
value is empty.
X XMPConst.SEPARATE_ALLOW_COMMAS — Allow commas in item values. If not
specified, an item containing a comma (such as "LastName, FirstName") is
separated into two array items.
Default is 0.
concatString
The string containing the concatenated array values, as returned by
catenateArrayItems()
.
Updates individual array item strings in the XMPMeta object
from a concatenated string returned by
catenateArrayItems()
. Recognizes a large set of separator characters, including semicolons, commas,
tab, return, linefeed, and multiple spaces.
Returns
undefined.
Kommentare zu diesen Handbüchern