
CHAPTER 10: Scripting Access to XMP Metadata XMPScript object reference 281
insertArrayItem()
XMPMetaObj.insertArrayItem(schemaNS, arrayName, itemIndex, itemValue[, itemOptions])
schemaNS
The namespace URI string. See “Schema namespace string constants” on
page 262.
arrayName
String. The name of an existing array. Can be a general path expression.
itemIndex
Number. The 1-based position index at which to insert the new item. Use
XMPConst.ARRAY_LAST_ITEM to reference the last existing item in the array.
itemValue
String. The new item value. Pass null for array items that do not have values.
itemOptions
Optional. A flag that describes the new item, if it is being created. One of:
0: A simple item, the default.
XMPConst.PROP_IS_ARRAY: The item is an array (of type alt, bag, or seq).
XMPConst.PROP_IS_STRUCT: The item is a structure with nested fields.
Inserts an item into an array, before an existing item. The index positions of all later items are
incremented. The array must exist.
Returns
undefined.
iterator()
XMPMetaObj.iterator(options, schemaNS, propName)
options
The set of options that control how the iteration is performed, and how values are
returned. A logical OR of these bit-flag constants:
X XMPConst.ITERATOR_JUST_CHILDREN — Limit iteration to immediate
children of the root property. By default, iterates into subtrees.
X XMPConst.ITERATOR_JUST_LEAFNODES — Limit iteration to leaf nodes. By
default, iterates into all nodes of a subtree.
X XMPConst.ITERATOR_JUST_LEAFNAMES — Return only the leaf part of the
path. By default, returns a full path.
X XMPConst.ITERATOR_INCLUDE_ALIASES — Include aliases. By default,
considers only actual properties.
X XMPConst.ITERATOR_OMIT_QUALIFIERS — Omit qualifiers from iteration.
schemaNS
The namespace URI string. See “Schema namespace string constants” on
page 262.
propName
The name string of a property within which to iterate. Can be a general path
expression.
Creates an iteration object that can iterate over the properties, arrays, and qualifiers within this
metadata. Specify options, a namespace, and a property to limit the range and granularity of the
resulting items.
Returns an XMPIterator object
for this metadata object.
Comentários a estes Manuais