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 three types of information that can be requested:
- 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.
- 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.
- 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.
A returned action test state of true implies that at least one file had modifications.
