This statement is used to return a list of modified items. Modified is defined as the initial and current metadata state values differ.
The items appear as a list of names in the specified track variable for each file. Items in the returned lists are delimited by the default list delimiter (\~). An empty track variable implies nothing was modified.
There are four types of information that can be requested:
- List of All Modified Fields
All fields including custom fields and multi items fields are tested for modifications. A field's name is added to the returned list if it is modified.
- List of Multi item fields are tested in their entirety. For example if Artwork is returned, at least one artwork item has been modified.
- Note that no indication is given for possible changes to chapters in an MPEG-4 file. You can test for chapter changes by means of the Has Modfied Chapters property.
- List of Modified User Defined Text Info Items
User Defined Text Info items are tested for modifications, deletions or creations. If any of these conditions hold for a particular User Defined Text Info item, its name is included in the returned list.
- Modified User Defined URL Items
User Defined URL items are tested for modifications, deletions or creations. If any of these conditions hold for a particular User Defined URL item, its name is included in the returned list.
- Text of Specified Field's Modifications
You specify the symbolic name of a field. The textual representation, if any, of the modifications to the field is returned. The field specification may contain any of the escape sequences described in Escape Sequences.
A returned action test state of true implies that at least one file had modifications.
