MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 154 / 554

154 Objects
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.)
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:
<rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'>
<rdf:Description rdf:about='' xmlns:dc='http://purl.org/dc/1.1/'>
<dc:title>Simple title</dc:title>
<dc:description>Simple description</dc:description>
</rdf:Description>
<rdf:Description rdf:about='' xmlns:xmp='http://ns.adobe.com/xap/1.0/'>
<xmp:CreateDate>2004-10-12T10:29-07:00</xmp:CreateDate>
<xmp:CreatorTool>Flash Authoring WIN 8,0,0,215</xmp:CreatorTool>
</rdf:Description>
</rdf:RDF>
NO
TE
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()
.