Adobe Extending Flash Professional CS5 - Manual (Page 169)

147 EXTENDING FLASH PROFESSIONAL
Document object
Last updated 5/2/2011
Parameters
strMetadata A string containing the XML metadata to be associated with the document. For more information, see
the following description.
Returns
A Boolean value:
true if successful; false otherwise.
Description
Method; sets the XML metadata for the specified document, overwriting any existing metadata. The XML passed as
strMetadata is validated and may be rewritten before being stored. If it cannot be validated as legal XML or violates
specific rules, then the XML metadata is not set and
false is returned. (If false is returned, there is no way to get
more detailed error information.)
Note: Even if
true is returned, the XML that is set may not be exactly the same string that you passed in. To get the exact
value to which the XML was set, use document.getMetadata() .
The format of the metadata is RDF that is compliant with the XMP specification. For more information about RDF
and XMP, see the following sources:
• The RDF Primer at www.w3.org/TR/rdf-primer/
• The RDF specification at www.w3.org/TR/1999/REC-rdf-syntax-19990222/
• The XMP home page at www.adobe.com/products/xmp/
Example
The following examples show several different legal ways to represent the same data. In all of these cases but the second
one, if the data were sent to
Document.setMetadata() , it would not be rewritten (aside from removing line breaks).
In the first example, metadata is in tags, with different schemas placed in separate rdf:Description tags:
Simple title
Simple description
2004-10-12T10:29-07:00
Flash Authoring WIN 8,0,0,215
In the second example, metadata is in tags, but with different schemas all in one rdf:Description tag. This example
also includes comments, which will be ignored and discarded by the Document.setMetadata() :