示例 下面的示例使用?<row>?标记来帮助定义对话框。要了解此对话框是如何与?JavaScript API?命令合作的，请参阅?<menulist>?的示例。 <dialog id="scale-dialog" title="Scale Selection" buttons="accept,cancel"> ???<grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="center"> ??????????????? <label value="Scale x: " control="xScale"/> ??????????????? <textbox id="xScale"/>??? ????????????</row> ??????????? <row align="center"> ??????????????? <label value="Scale y:" control="yScale"/> ??????????????? <textbox id="yScale" /> ??????????? </row> ????????</rows> ????</grid> </dialog> <rows>
可用性 Flash MX 2004。
用法 <rows> ??? ... ??? child tags ???... </rows>
属性 无。
子标记 <row>
父标记 <grid>
说明 布局标记；创建表格网格布局中的?row?标记的容器标记。columns?标记必须在?<grid>?标记内部。
示例 下面的示例使用?<grid>、<columns>?和?<rows>?标记来定义对话框。要了解此对话框是如何与?JavaScript API?命令合作的，请参阅 ??? <grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="center"> ??????????????? <label value="Scale x: " control="xScale"/> ??????????????? <textbox id="xScale"/>??? ????????????</row> ??????????? <row align="center"> ??????????????? <label value="Scale y:" control="yScale"/> ??????????????? <textbox id="yScale" /> ??????????? </row> ????????</rows> ????</grid> </dialog> <separator>
可用性 Flash MX 2004。
用法 <separator/>
属性 无。
子标记 无。
父标记 <hbox>、<vbox>
说明 布局标记；创建在?<hbox>?中垂直显示，在?<vbox>?中则水平显示的分隔线。
示例 下面的示例向"指定帧提示点导航"行为对话框添加分隔线。当前对话框（为?Flash MX 2004?自带）是在?CuePointNamedFrame.xml?文件中定义的。 <dialog id="NamedFrameCuePointDialog" title="指定帧提示点导航" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <label value="选择带有如下指定帧的剪辑:" control="target" required="true" /> ??????????? <targetlist id="target" class="movieclip" /> ??????? </hbox> ????????<hbox> ??????????? <checkbox id="stop" label="跳至并停止？(跳至并播放)" checked="false" /> ??????? </hbox> ????</vbox> </dialog> 这些标记生成下面的对话框： 下面的示例添加了分隔线并删除了?<hbox>?标记： <dialog id="NamedFrameCuePointDialog" title="指定帧提示点导航" buttons="accept,cancel"> ??? <vbox> ??????? <label value="选择带有如下提定帧的剪辑:" control="target" required="true" /> ??????? <targetlist id="target" class="movieclip" /> ??????? <separator/> ??????? <checkbox id="stop" label="跳至并停止？(跳至并播放)" checked="false" /> ??? </vbox> </dialog> 修改后的标记生成下面的对话框：
<spacer>
可用性 Flash MX 2004。
用法 <spacer/>
属性 无。
子标记 无。
父标记 <column>、<hbox>、<row>、<vbox>
说明 布局标记；创建用于排列控件的透明填充间隔。
示例 下面的示例使用?JavaScript API?创建了一个简单的命令，可将所选值发送到"输出"面板。创建文件（如本部分所述），并放入用户级配置文件夹中的?Commands?文件夹。 创建一个名为?Trace Selections.jsfl?的文件。把下面的代码放入该文件并保存文件： //在 Trace Selections.xml 文件中使用 XML 定义 //创建"XML 转化为 UI"对话框 var traceSelectionsDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/Trace Selections.xml" ); ? if (traceSelectionsDlg.dismiss == "accept") { ??? fl.trace("Checkbox 1: " + traceSelectionsDlg.checkbox1); ??? fl.trace("Checkbox 2: " + traceSelectionsDlg.checkbox2); ??? fl.trace("Checkbox 3: " + traceSelectionsDlg.checkbox3); ??? fl.trace("Checkbox 4: " + traceSelectionsDlg.checkbox4); ??? fl.trace("Checkbox 5: " + traceSelectionsDlg.checkbox5); } 然后，创建一个名为?Trace Selections.xml?的文件（本示例没有使用?<spacer/>?标记，因此第二行复选框控件左对齐）。把下面的代码放入该文件并保存文件： <dialog id="traceSelections" title="Trace Selections" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <checkbox id="checkbox1" label="checkbox1"/> ??????????? <checkbox id="checkbox2" label="checkbox2"/> ??????????? <checkbox id="checkbox3" label="checkbox3"/> ??????? </hbox> ??????? <hbox> ??????????? <checkbox id="checkbox4" label="checkbox4"/> ??????????? <checkbox id="checkbox5" label="checkbox5"/> ??????? </hbox> ??? </vbox> </dialog> 这时，"命令"菜单上出现?Trace Selections?命令。如果从"命令"菜单中选择?Trace Selections?命令，则出现?Trace Selections.xml?定义的对话框，如下图所示： 最后，把?<spacer/>?标记添加到?Trace Selections.xml?文件： <dialog id="traceSelections" title="Trace Selections" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <checkbox id="checkbox1" label="checkbox1"/> ??????????? <checkbox id="checkbox2" label="checkbox2"/> ??????????? <checkbox id="checkbox3" label="checkbox3"/> ??????? </hbox> ??????? <hbox> ??????????? <spacer/> ??????????? <checkbox id="checkbox4" label="checkbox4"/> ??????????? <checkbox id="checkbox5" label="checkbox5"/> ??????? </hbox> ??? </vbox> </dialog> 向第二行复选框添加?<spacer/>?标记会使?checkbox4?和?checkbox5?移向右边：
<vbox>
可用性 Flash MX 2004。
用法 <vbox> ??? ... ??? child tags ??? ... </vbox>
属性 无。
子标记 <vbox>、控件标记
父标记 <grid>
说明 布局标记；创建垂直布局项目的容器。
示例 下面的示例使用?<vbox>?和?<hbox>?标记，重新定义?<popupslider>?示例中所用的基于?<grid>?的对话框： <dialog id="skew-dialog" title="Skew Selection" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <label value="Skew x: " control="xSkew" align="left"/> ??????????? <popupslider id="xSkew" minvalue="-180" maxvalue="180"/>??? ????????</hbox> ??????? <hbox> ??????????? <label value="Skew y:" control="ySkew" align="left"/> ??????????? <popupslider id="ySkew" minvalue="-180" maxvalue="180"/> ??????? </hbox> ??????? <hbox> ??????????? <label value="Edge:" control="edge" align="left"/> ??????????? <menulist id="edge"> ??????????????? <menupop> ??????????????????? <menuitem label="top center"/> ??????????????????? <menuitem label="right center"/> ??????????????????? <menuitem label="bottom center"/> ??????????????????? <menuitem label="left center"/> ??????????????? </menupop> ??????????? </menulist> ??????? </hbox> ????</vbox> </dialog> 下图所示的"Skew Selection"对话框是使用?<vbox>?和?<hbox>?标记代替?<grid>?标记定义的。VBox?和?HBox?容器上分别添加了红蓝轮廓，以便说明这些容器标记是如何用于定义此布局的：
<button>
可用性 Flash MX 2004。
用法 <button ????id="myID" ????label="myLabel" ????tabindex="myIdx" ????accesskey="myChar"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
label?字符串；是显示在按钮上的文本。
tabindex?数字；是个整数，用于设置控件在选项卡顺序中的位置（仅限?Windows）。
accesskey?字符串；是个字符，用于此控件的快捷键（仅限?Windows）。
oncommand?JavaScript?命令，单击此按钮时执行。
子标记 无。
父标记 <dialog>、<vbox>
说明 控件标记；创建按钮控件。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?button.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： //在 button.xml 文件中使用 XML 定义 //创建"XML 转化为 UI"对话框 var buttonDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/button.xml" ); 然后，创建一个名为?button.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <?xml version="1.0"?> <dialog id="button-dialog" title="Button Example" buttons="accept,cancel"> ??? <grid> ??????? <columns> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row> ??????????????? <label width="150" value="The following buttons will send text to the Output Panel"/> ??????????? </row> ??????????? <row> ??????????????? <button id="helloBtn"? label="Hello" oncommand="fl.trace('Hello')"/> ??????????? </row> ??????????? <row> ??????????????? <button id="worldBtn" label="world" oncommand="fl.trace('world')"/>??? ????????????</row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现?button?命令。如果已经打开了一个?Flash?文档，则可以从"命令"菜单中选择?button?命令，会出现?button.xml?定义的对话框。 <checkbox>
可用性 Flash MX 2004。
用法 <checkbox ????id="myID" ????label="myLabel" ????tabindex="myIdx" ????checked="true|false" ????accesskey="myChar"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
label?字符串；是显示在复选框旁的文本。
tabindex?数字；是个整数，用于设置控件在选项卡顺序中的位置（仅限?Windows）。
checked?布尔值；设置默认值。若为?true，则首次出现对话框时已选择该框；若为?false，则情况相反。
accesskey?字符串；是个字符，用于此控件的快捷键（仅限?Windows）。
子标记 无。
父标记 <vbox>
说明 控件标记；创建复选框控件。
示例 下面的示例选自?Labeled Frame CuePoint Navigation?行为定义文件： <dialog id="NamedFrameCuePointDialog" title="Labeled Frame CuePoint Navigation" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <label value="Select clip with labeled frames:" control="target"/> ??????????? <targetlist id="target" class="movieclip" /> ??????? </hbox> ????????<hbox> ??????????? <checkbox id="stop" label="gotoAndStop? (vs gotoAndPlay)" checked="false" /> ??????? </hbox> ????</vbox> </dialog> <choosefile>
可用性 Flash MX 2004。
用法 <choosefile ????id="myID" ????literal="true|false" ????pathtype="relative|absolute" ??? required="true|false" ??? size="mySize" ??? tabindex="myIdx" ??? type=""open|save ??? value="myValue" ??? width="myWidth"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
literal?布尔值；若为?true，则控件返回的值带引号?("")。若为?false（默认设置），则返回的值不带引号?("")。
pathtype?字符串；两个可能的值是?relative?和?absolute。
required?布尔值：若为?true，则只有为此控件输入值后，"确定"按钮才有效；若为?false，则控件不影响"确定"按钮。
size?数字；是个整数，使用平均字符宽度设置输入字段的宽度。
tabindex?数字；是个整数，用于设置控件在选项卡顺序中的位置（仅限?Windows）。
type?字符串；可以是"open"?或?"save"。
value?字符串；是显示在文本输入区的默认文本。
width?数字；设置文本输入区的宽度，以像素为单位。
子标记 无。
父标记 <vbox>
说明 控件标记；创建文件选择器控件（不属于?XUL?标准）。用户可用此控件访问操作系统的文件选择对话框。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?choosefile.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： //在 choosefile.xml 文件中使用 XML 定义 //创建"XML 转化为 UI"对话框 var chooseFileDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/choosefile.xml" ); if (chooseFileDlg.dismiss == "accept") { ????var path = chooseFileDlg.choosefileControl; ??? fl.trace(path); } 然后，创建一个名为?choosefile.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <?xml version="1.0"?> <dialog id="choosefile-dialog" title="Choose File Example" buttons="accept,cancel"> ??? <vbox> ??????? <label value="Please select a file: "/> ??????? <choosefile id="choosefileControl" type="open" pathtype="relative"/> ??? </vbox> </dialog> 这时，"命令"菜单上出现?choosefile?命令。如果已经打开了一个?Flash?文档，则可以从"命令"菜单中选择?choosefile?命令，会出现choosefile.xml?定义的对话框，如下图所示： <colorchip>
可用性 Flash MX 2004。
用法 <colorchip ????id="myID" ????color="myColor"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
color?数字；是个十六进制数字，代表用作默认值的颜色。
子标记 无。
父标记 <vbox>
说明 控件标记；创建颜色选择器控件（不属于?XUL?标准）。此标记为?Flash?特有，不属于?XUL?标记集。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?setcolor.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： //在 setcolor.xml 文件中使用 XML 定义 //创建"XML 转化为 UI"对话框 var setcolorDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/setcolor.xml" ); ? if (setcolorDlg.dismiss == "accept") { ????fl.getDocumentDOM().setFillColor(setcolorDlg.fillColor); ??? fl.getDocumentDOM().setStrokeColor(setcolorDlg.strokeColor); } 然后，创建一个名为?setcolor.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <dialog id="setcolor-dialog" title="Set Color" buttons="accept,cancel"> ??? <grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="left"> ??????????????? <label value="Set fill color: " control="fillColor" align="left"/> ??????????????? <colorchip id="fillColor" color="#000000"/>??? ????????????</row> ??????????? <row align="left"> ??????????????? <label value="Set stroke color:" control="strokeColor" align="left"/> ??????????????? <colorchip id="strokeColor" color="#000000"/> ??????????? </row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现?setcolor?命令。如果已经打开了一个?Flash?文档，请在舞台上绘制一个形状，然后从"命令"菜单中选择setcolor?命令。会出现?setcolor.xml?定义的对话框，如下图所示：
<flash>
可用性 Flash MX 2004。
用法 <flash ????id="myID" ????width="x" ????height="y" ????src="SWF file"> ??? ... ??? child tags ??? ... </flash>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
width?数字；设置?<flash>?控件的宽度，以像素为单位。
height?数字；设置?<flash>?控件的高度，以像素为单位。
src?字符串；是要嵌入到对话框中的?SWF?文件的路径。
子标记 <property>
父标记 <vbox>
说明 控件标记；创建嵌入的?SWF?文件的容器（不属于?XUL?标准）。JavaScript API?中的?xmlui?对象允许获取和设置嵌入的?SWF?文件中的参数值。
示例 下面的示例选自?blur.xml?文件，为?Blur Timeline Effect?定义了对话框。 <dialog id="blur-dialog" title="Blur"> ????<flash id="blur_ui" src="blur.swf" width="772" height="456"> ??????? <property id="first" /> ??????? <property id="dur" /> ??????? <property id="hor" /> ??????? <property id="vert" /> ??????? <property id="regPoint" /> ??????? <property id="blur_amount" /> ??????? <property id="baseScale" /> ??? </flash> </dialog> <label>
可用性 Flash MX 2004。
用法 <label ????control="myControlID" ????accesskey="char" ????value="myText" ????align="left|center|right"/>
属性 control?字符串；是与关联控件的?ID?值匹配的字符串标识符。
accesskey?字符串；是个字符，用于此控件的快捷键（仅限?Windows）。
align?字符串；left、center?或?right?分别确定文本是左对齐、居中对齐还是右对齐。
value?字符串；是显示在对话框中的文本。
子标记 无。
父标记 <vbox>
说明 控件标记；创建可以与其它控件关联的文本标签。
示例 下面的示例选自?HideScreen.xml?文件，定义了"Hide Screen Behavior"。 <dialog id="SelectScreenDialog" title="Select Screen" buttons="accept,cancel"> ??? <vbox> ??????? <hbox> ??????????? <label value="Select Screen:" control="TARGET"/> ??????????? <targetlist id="TARGET" class="screen" /> ??????? </hbox> ????</vbox> </dialog> <listbox>
可用性 Flash MX 2004。
用法 <listbox ????id="myID" ????tabindex="myIdx" ????rows="numRows"> ??? ... ??? child tags ??? ... </listbox>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
rows?数字；是个整数，代表列表框中显示的行数。
tabindex?数字；是个整数，用于设置控件在选项卡顺序中的位置（仅限?Windows）。
子标记 <listitem>
父标记 <vbox>
说明 控件标记；创建列表框控件，以包含?<listitem>?标记。
示例 下面的示例修改了?<popupslider>?中的?skew?命令示例，以便对传递给?JavaScript skewSelection()?方法的?edge?参数使用?<listbox>?控件，而不是?<menulist>?控件。 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?skewlist.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： // 在 skew.xml 文件中使用 XML 定义创建"XML 转化为 UI"对话框 var skewlistDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/skewlist.xml" ); ? // 把对话框中的 xskew 和 yskew 的值放入本地变量。 // 注意：我们把 skewlistDlg["xSkew"] 的返回值转换为数字后，才分配 // 给 xSkew，因为 skewSelection 方法把数字视为参数。 var xSkew = Number(skewlistDlg.xSkew); var ySkew = Number(skewlistDlg.ySkew); var edge = skewlistDlg.edge; ? if (skewlistDlg.dismiss == "accept") { ? ??? // 把对话框中的 xSkew 和 ySkew 的值放入 ??? // 本地变量。此代码把对话框中的值转换为 ??? // 数字后，才分配给本地变量， ??? // 因为 skewSelection() 方法把数字视为 ??? // xSkew 和 ySkew 参数。 ??? var xSkew = Number(skewlistDlg.xSkew); ??? var ySkew = Number(skewlistDlg.ySkew); ??? var edge??? = skewlistDlg.edge; ? ??? // 检查是否为有效输入，因为发送 0 或 undefined 到 ??? // skewSelection() 会使对象消失。 ??? var inputIsValid = true; ??? if (xSkew == 0 || isNaN(xSkew)) { ??????? inputIsValid = false; ??? } ??? if (ySkew == 0 || isNaN(ySkew)) { ??????? inputIsValid = false; ??? } ? ??? // 调用 skewSelection() 来执行调整大小命令。 ??? if (inputIsValid ) { ??????? fl.getDocumentDOM().skewSelection(xSkew,ySkew,edge); ????} } 然后，创建一个名为?skewlist.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <dialog id="skewlist-dialog" title="Skew Selection" buttons="accept,cancel"> ??? <grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="left"> ?????????????? ?<label value="Skew x: " control="xSkew" align="left"/> ??????????????? <popupslider id="xSkew" minvalue="-180" maxvalue="180"/> ??????????? </row> ??????????? <row align="left"> ??????????????? <label value="Skew y:" control="ySkew" align="left"/> ?????? ?????????<popupslider id="ySkew" minvalue="-180" maxvalue="180"/> ??????????? </row> ????????????<row align="left"> ??????????????? <label value="Edge:" control="edge" align="left"/> ??????????????? <listbox id="edge" rows="5"> ??????????????????? <listitem label="top center"/> ??????????????????? <listitem label="right center"/> ??????????????????? <listitem label="bottom center"/> ??????????????????? <listitem label="left center"/> ??????????????? </listbox> ??????????? </row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现?skewlist?命令。在舞台上绘制一个形状，然后用指针工具选中它。如果从"命令"菜单中选择?skewlist?命令，则出现?skewlist.xml?定义的对话框，如下图所示： <listitem>
可用性 Flash MX 2004。
用法 <listitem ????label="mylabel" ????value="myValue"/>
属性 label?字符串；是显示在列表框中的该项目的文本。
value?字符串；用户选择此项目时返回的文本。如果没有设置，则返回?label?属性的值。
子标记 无。
父标记 <listbox>
说明 控件标记；创建列表框控件中的单个项目。此标记必须用于?<listbox>?标记内部。
示例 请参阅?<listbox>?的示例。 <menulist>
可用性 Flash MX 2004。
用法 <menulist ????="myID" id ????="myIdx">tabindex ??? <menupop> ??????? <menuitem/> ??????? ... ??????? <menuitem/> ??? </menupop> </menulist>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
tabindex?数字；是个整数，用于设置控件在选项卡顺序中的位置（仅限?Windows）。
子标记 <menupop>
父标记 <vbox>
说明 控件标记；创建包含?<menupop>?和?<menuitem>?标记的弹出菜单控件。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的一个?Convert to Symbol?新命令。此命令是"修改"菜单上"Convert to Symbol"对话框的简化形式。创建两个文件（如本部分所述），并放入用户级配置文件夹中的?Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?Convert to Symbol.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： // 在 Convert to Symbol.xml 文件中使用 XML 定义 // 创建"XML 转化为 UI"对话框 var convertToSymbolDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/Convert to Symbol.xml" ); ? if (convertToSymbolDlg.dismiss == "accept") { ??? var type = new String(convertToSymbolDlg.type); ??? fl.getDocumentDOM().convertToSymbol(type.toLowerCase(),convertToSymbolDlg.name,convertToSymbolDlg.registration); } 然后，创建一个名为?Convert to Symbol.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <dialog id="convertToSymbolDlg" title="Convert to Symbol" buttons="accept,cancel"> ??? <grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="right"> ??????????????? <label value="Name: " control="name" align="right"/> ??????????????? <textbox id="name" value="Symbol 1"/>??? ????????????</row> ??????????? <row><spacer/></row> ??????????? <row align="right"> ??????????????? <label value="Behavior:" control="type" align="right"/> ??????????????? <radiogroup id="type"> ??????????????????? <radio label="Movie clip"/> ??????????????????? <radio label="Button"/> ??????????????????? <radio label="Graphic"/> ?? ?????????????</radiogroup> ??????????? </row> ????????????<row align="right"> ??????????????? <label value="Registration:" control="registration"/> ??????????????? <menulist id="registration"> ??????????????????? <menupop> ??????????????????????? <menuitem label="top left"/> ??????????????????????? <menuitem label="top center"/> ??????????????????????? <menuitem label="top right"/> ??????????????????????? <menuitem label="center left"/> ??????????????????????? <menuitem label="center"/> ?????????????????? ?????<menuitem label="center right"/> ??????????????????????? <menuitem label="bottom left"/> ??????????????????????? <menuitem label="bottom center"/> ??????????????????????? <menuitem label="bottom right"/> ??????????????????? </menupop> ??????????????? </menulist> ??????????? </row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现?Convert to Symbol?命令。在舞台上绘制一个形状，然后用指针工具选中它。如果从"命令"菜单中选择?Convert to Symbol?命令，则出现?Convert to Symbol.xml?定义的对话框，如下图所示： <menupop>
可用性 Flash MX 2004。
用法 <menulist> ??? <menupop> ??????? <menuitem/> ??????? ... ??????? <menuitem/> ?? ?</menupop> </menulist>
属性 无。
子标记 <menuitem>
父标记 <menulist>
说明 控件标记；创建弹出菜单控件的弹出菜单，并且必须至少包含一个?<menuitem>?标记。
示例 以下示例创建了带?8?个元素的弹出菜单控件。要查看整个对话框的?XML?定义，请参阅?<menulist>?的示例。 <menulist id="registration"> ? ??<menupop> ??????? <menuitem label="top left"/> ??????? <menuitem label="top center"/> ??????? <menuitem label="top right"/> ??????? <menuitem label="center left"/> ??????? <menuitem label="center"/> ??????? <menuitem label="center right"/> ??????? <menuitem label="bottom left"/> ??????? <menuitem label="bottom center"/> ??????? <menuitem label="bottom right"/> ??? </menupop> </menulist>
<menuitem>
可用性 Flash MX 2004。
用法 <menulist> ??? <menupop> ??????? <menuitem ??????????? label="displayText" ??????????? value="itemValue"/> ??????? ... ??????? <menuitem ??????????? label="displayText" ??????????? value="itemValue"/> ??? </menupop>
属性 label?字符串；是显示在弹出菜单中的该项目的文本。
value?字符串；用户选择此项目时返回的文本。如果没有设置，则返回?label?属性的值。
子标记 无。
父标记 <menupop>
说明 控件标记；创建弹出菜单控件的弹出项目，并且必须至少包含一个?<menuitem>?标记。
示例 以下示例创建了带?8?个元素的下拉菜单控件。要查看整个对话框的?XML?定义，请参阅?<menulist>?的示例。 <menulist id="registration"> ??? <menupop> ??????? <menuitem label="top left"/> ??????? <menuitem label="top center"/> ??????? <menuitem label="top right"/> ??????? <menuitem label="center left"/> ??????? <menuitem label="center"/> ??????? <menuitem label="center right"/> ??????? <menuitem label="bottom left"/> ??????? <menuitem label="bottom center"/> ??????? <menuitem label="bottom right"/> ??? </menupop> </menulist> <popupslider>
可用性 Flash MX 2004。
用法 <popupslider ="myLabel" ????id ="" ????tabindex ="" ????minvalue =""/>????maxvalue
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
tabindex?数字；是个整数，代表控件在选项卡顺序中的位置（仅限?Windows）。
minvalue?数字；是个整数，代表最小值。
maxvalue?数字；是个整数，代表最大值。
子标记 无。
父标记 <vbox>
说明 控件标记；创建弹出滑块控件（不属于?XUL?标准）。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，创建一个名为?skew.jsfl?的文件，并放入?Commands?文件夹中。把下面的代码放入该文件并保存文件： // 在 skew.xml 文件中使用 XML 定义创建"XML 转化为 UI"对话框 var skewDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/skew.xml" ); ? // 把对话框中的 xskew 和 yskew 的值放入本地变量。 // 注意：我们把 skewDlg["xSkew"] 的返回值转换为数字后，才分配 // 给 xSkew，因为 skewSelection 方法把数字视为参数。 var xSkew = Number(skewDlg.xSkew); var ySkew = Number(skewDlg.ySkew); var edge = skewDlg.edge; ? if (skewDlg.dismiss == "accept") { ? ??? // 把对话框中的 xSkew 和 ySkew 的值放入 ??? // 本地变量。此代码把对话框中的值转换为 ??? // 数字后，才分配给本地变量， ??? // 因为 skewSelection() 方法把数字视为 ??? // xSkew 和 ySkew 参数。 ??? var xSkew = Number(skewDlg.xSkew); ??? var ySkew = Number(skewDlg.ySkew); ??? var edge??? = skewDlg.edge; ? ??? // 检查是否为有效输入，因为发送 0 或 undefined 到 ??? // skewSelection() 会使对象消失。 ??? var inputIsValid = true; ??? if (xSkew == 0 || isNaN(xSkew)) { ??????? inputIsValid = false; ??? } ??? if (ySkew == 0 || isNaN(ySkew)) { ??????? inputIsValid = false; ??? } ? ??? // 调用 skewSelection() 来执行调整大小命令。 ??? if (inputIsValid ) { ??????? fl.getDocumentDOM().skewSelection(xSkew,edge); ????} } 然后，创建一个名为?skew.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <dialog id="skew-dialog" title="Skew Selection" buttons="accept,cancel"> ??? <grid> ??????? <columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="left"> ??????????????? <label value="Skew x: " control="xSkew" align="left"/> ??????????????? <popupslider id="xSkew" minvalue="-180" maxvalue="180"/> ??????????? </row> ??????????? <row align="left"> ??????????????? <label value="Skew y:" control="ySkew" align="left"/> ??????????????? <popupslider id="ySkew" minvalue="-180" maxvalue="180"/> ??????????? </row> ????????????<row align="left"> ??????????????? <label value="Edge:" control="edge" align="left"/> ??????????????? <menulist id="edge"> ??????????????????? <menupop> ??????????????????????? <menuitem label="top center"/> ??????????????????????? <menuitem label="right center"/> ??????????????????????? <menuitem label="bottom center"/> ??????????????????????? <menuitem label="left center"/> ??????????????????? </menupop> ??????????????? </menulist> ???????????</row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现倾斜命令。在舞台上绘制一个形状，然后用指针工具选中它。如果从"命令"菜单中选择?倾斜命令，则出现skew.xml?定义的对话框，如下图所示： <property>
类别 Flash MX 2004。
用法 <property ??? id="myID"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
子标记 无。
父标记 <flash>
说明 控件标记；创建嵌入的?SWF?文件中的自定义属性；与?<flash>?标记一起使用。此标记用于声明嵌入到"XML?转化为?UI"对话框中的?SWF文件所特有的属性。
示例 请参阅?<flash>?的示例。 <radiogroup>
可用性 Flash MX 2004。
用法 <radiogroup = "myID" ????id = "myLabel"????label ???groupbox = "true|false"> ??? <radio/> ??? ... ??? <radio/> </radiogroup>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
label?字符串；定义显示在单选按钮组上方的字符串。
groupbox?布尔值；若为?true，则整个单选按钮组有边框。
子标记 <radio>
父标记 <vbox>
说明 控件标记；创建单选按钮控件组的容器。此标记允许组合单选按钮，并且必须至少包含一个?<radio>?标记。
示例 下面的示例定义了?<menulist>?的示例中包含的一组?<radio>?控件。要查看完整示例，请参阅?<menulist>。 <radiogroup id="type"> ??? <radio label="Movie clip"/> ??? <radio label="Button"/> ??? <radio label="Graphic"/> </radiogroup> <radio>
可用性 Flash MX 2004。
用法 <radiogroup> ??? <radio label="myLabel" selected="" accesskey=""/> ??? ... </radiogroup>
属性 label?显示在单选按钮旁的文本。
selected?布尔值；若为?true，则该单选按钮是单选组中的默认选择。
accesskey?字符串；是个字符，用于此控件的快捷键（仅限?Windows）。
子标记 无。
父标记 <radiogroup>
说明 控件标记；创建单个单选按钮控件。此标记必须用于?<radiogroup>?标记内部。
示例 下面的示例定义了?<menulist>?的示例中包含的一组?<radio>?控件。要查看完整示例，请参阅?<menulist>。 <radiogroup id="type"> ??? <radio label="Movie clip"/> ??? <radio label="Button"/> ??? <radio label="Graphic"/> </radiogroup> <targetlist>
可用性 Flash MX 2004。
用法 <targetlist ="myLabel" ????id ="myClass1[,myClass2][,...,myClassN]" ????class ????="true|false" required ????="relative|absolute"/>pathtype
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
class?要为之列出实例的类。
required?布尔值；若为?true，则只有为此控件输入值后，"确定"按钮才有效；若为?false?则控件不影响"确定"按钮。
pathtype?字符串；两个可能的值是?relative?和?absolute。?
子标记 无。
说明 控件标记；创建一个列出类的所有实例并供用户选择的控件。
示例 下面的示例选自加载图像行为定义文件。该标记定义了?targetlist?控件，供用户选择图形加载到的影片剪辑。要查看完整的对话框定义，请参阅?Behaviors?文件夹中的?Graphic_load_graphic.xml?文件。 <vbox> ??? <label value=""/> ??? <label value="选择要将该图像载入到哪个影片剪辑:"/> ??? <targetlist id="target" class="movieclip"/> </vbox> <targetlist>?标记创建的控件如下图所示：
<textbox>
可用性 Flash MX 2004。
用法 <textbox ????id = "myID" ????literal = "true|false" ????maxlength = "myLength" ????multiline = "true|false" ????size = "mySize" ????tabindex = "myIdx" ????value = "myValue"/>
属性 id?字符串；代表唯一的标识字符串，供可扩展功能用于标识控件和访问控件返回的值。
literal?布尔值；若为?true，则此控件返回的值带引号?("")。若为?false（默认设置），则返回的值不带引号?("")。
maxlength?数字；设置最多可输入的字符数。
multiline?布尔值；若为?true，则允许多行输入。若为?false（默认设置），则只允许输入一行。
size?数字；是个整数，使用平均字符宽度设置输入字段的宽度。
tabindex?数字；是个整数，代表控件在选项卡顺序中的位置（仅限?Windows）。
value?字符串；是显示在文本框中的默认文本。
子标记 无。
父标记 <vbox>
说明 控件标记；创建允许输入文本的控件。
示例 下面的示例使用?JavaScript API?来创建"命令"菜单中显示的新命令。创建两个文件（如本部分所述），并放入用户级配置文件夹中的Commands?文件夹。有关详细信息，请参阅"Flash?入门"中的随 Flash?安装的配置文件夹。 首先，在?Commands?文件夹中创建一个名为?scale.jsfl?的文件。把下面的代码放入该文件并保存文件： // 在 scale.xml 文件中使用 XML 定义 // 创建"XML 转化为 UI"对话框 var scaleDlg = fl.getDocumentDOM().xmlPanel( fl.configURI + "Commands/scale.xml" ); ? if (scaleDlg.dismiss == "accept") { ? ??? // 把对话框中的 xScale 和 yScale 值放入 ??? // 本地变量。此代码把对话框中的值转换为 ??? // 数字后，才分配给本地变量， ??? // 因为 scaleSelection() 方法把数字视为参数。 ??? var xScale = Number(scaleDlg.xScale); ??? var yScale = Number(scaleDlg.yScale); ??? ? ??? // 检查是否为有效输入，因为发送 0 或 undefined 到 ??? // scaleSelection() 会使对象消失。 ??? var inputIsValid = true; ??? if (xScale == 0 || isNaN(xScale)) { ??????? inputIsValid = false; ??? } ??? if (yScale == 0 || isNaN(yScale)) { ??????? inputIsValid = false; ??? } ? ??? // 调用 scaleSelection 来执行调整大小命令。 ??? if (inputIsValid ) { ??????? fl.getDocumentDOM().scaleSelection(xScale,yScale); ????} } 然后，创建一个名为?scale.xml?的文件，并放入?Commands?文件夹。把下面的代码放入该文件并保存文件： <?xml version="1.0"?> <dialog id="scale-dialog" title="Scale Selection" buttons="accept,cancel"> ??? <grid> ???? ???<columns> ??????????? <column/> ??????????? <column/> ??????? </columns> ??????? <rows> ??????????? <row align="center"> ??????????????? <label value="Scale x: " control="xScale"/> ??????????????? <textbox id="xScale"/>??? ????????????</row> ????????? ??<row align="center"> ??????????????? <label value="Scale y:" control="yScale"/> ??????????????? <textbox id="yScale" /> ??????????? </row> ????????</rows> ????</grid> </dialog> 这时，"命令"菜单上出现缩放命令。在舞台上绘制一个形状，然后用指针工具选中它。如果从"命令"菜单中选择缩放命令，则出现scale.xml?定义的对话框，如下图所示： 关于配置文件夹 配置文件夹包含?Flash 8?应用程序的可自定义元素。如果您自定义或扩展?Flash 8，可修改这些文件或将源文件添加到一个或多个配置文件夹中。通过熟悉这些文件夹，可以了解?Flash 8?提供的用于扩展的接口。
| 警告 |
? |
配置文件夹中的文件构成了?Flash 8?接口的大部分内容。请勿修改、删除这些文件或者添加文件，除非您知道如何自定义和扩展Flash 8。 |
配置文件夹位于三个不同的位置中，具体情况取决于您的操作系统。第一个文件夹（即应用程序配置）的位置与应用程序有关。第二个文件夹（即用户配置）存储于计算机的当前活动用户可写入的位置。此位置将会位于以下一个文件夹位置，具体情况取决于您的操作系统： 用户配置： Windows：
- 98?第二版：C:Windows DirectoryApplication DataMacromediaFlash 8
- 2000?和?XP：C:Documents and Settings用户名Local SettingsApplication DataMacromediaFlash 8
Mac OS：
- Mac OS X：Hard Disk/Users/用户名/Library/Application Support/Macromedia/Flash 8
第三个文件夹（即所有用户配置）是?HelpPanel?所在的文件夹。取决于您的操作系统，此位置将会是以下其中之一： 所有用户配置： Windows：
- 98?第二版：C:Windows DirectoryAll UsersApplication DataMacromediaFlash 8
- 2000?和?XP：C:Documents and SettingsAll UsersLocal SettingsApplication DataMacromediaFlash 8
Mac OS：
- Mac OS X：Hard Disk/Users/Shared/Library/Application Support/Macromedia/Flash 8
应用程序级配置目录 应用程序配置文件夹为：
| 文件/文件夹名 |
内容 |
| authplay.dll/authplaylib |
在创作工具中使用的外部?Macromedia Flash Player（测试影片、调试影片）。 |
| Components* |
已编译的组件?SWC?文件的位置，这些文件驱动"组件"面板。 |
| Components FLA |
示例组件的源文件。 |
| Configuration.xml |
可用于配置?Flash 8，使其在退出时删除?aso?文件夹。 |
| Dictionaries |
拼写检查器使用的字典文件。 |
| HelpSWF |
"帮助"菜单中使用的?Macromedia Flash?内容。 |
| Importers* |
用于扩展?Flash?中可用的导入器的文件。 |
| Libraries* |
驱动"窗口">"公用库"菜单的?FLA?源文件的位置。 |
| Templates* |
驱动"文件">"从模板新建..."对话框的?FLA?源文件的位置。 |
*这些文件夹/文件可位于"Application Data"配置文件夹和"User"配置文件夹中。当这两个文件夹中有同名文件时，用户级配置优先。Extension Manager?将文件安装到"User"配置文件夹中。 用户级配置目录 用户配置文件夹为：
| 文件/文件夹名 |
内容 |
| missfont.map |
? |
| ActionsPanel |
用于自定义"动作"面板的文件：
- ActionsPanel.xml：工具箱内容的配置?XML
- AsCodeHints.xml：代码提示的配置?XML
- AsColorSyntax.xml：彩色语法突出显示的配置?XML
- Custom Actions：用于将自定义的动作添加到工具箱的文件。
|
| Behaviors |
定义行为的?XML?文件。 |
| Classes |
ActionScript?的类文件。 |
| Color Sets |
颜色管理系统使用的颜色设置。 |
| Commands |
JSFL?和?XML?文件，它们定义可通过"命令"菜单找到的?JavaScript?命令。 |
| Data Types |
定义在数据绑定架构面板中使用的数据类型的?XML?文件。 |
| Detection |
Flash Player?检测工具包使用的文件。 |
| Effects |
定义特效的?XML?文件。 |
| Encoders |
定义在数据绑定架构面板中使用的编码器的?XML?文件。 |
| Font Embedding |
包含字体嵌入表的?XML?文件。 |
| Formatters |
定义在数据绑定架构面板中使用的格式程序的?XML?文件。 |
| HTML |
用于发布命令的?HTML?模板。 |
| Include |
全局?ActionScript?的包含文件的位置。 |
| Keyboard Shortcuts |
指定在?Flash MX?中可用的自定义快捷键和助记键设置。 |
| Kinds |
定义在数据绑定架构面板中使用的种类的?XML?文件。 |
| Panel Sets |
指定在?Flash MX?中可用的默认、开发人员、设计人员和自定义的面板设置。 |
| Publish Profiles |
XML?文件的位置，这些文件存储可在"文件">"发布设置..."对话框中找到的配置文件。 |
| Screen Types |
定义在创作工具中使用的幻灯片和表单屏幕的数据文件。 |
| StartPage |
FLA?源文件的位置，这些源文件由"文件">"另存为模板..."所放置，并驱动"文件">"从模板新建..."对话框。 |
| Templates* |
FLA?源文件的位置，这些源文件由"文件">"另存为模板..."所放置，并驱动"文件">"从模板新建..."对话框。 |
| Tools |
定义工具的?JSFL?和?XML?文件 |
| Video |
包含视频编码配置文件。 |
| WindowSWF |
在"窗口"菜单中使用的?Macromedia Flash?内容。 |
*这些文件夹/文件可位于"Application Data"配置文件夹和"User"配置文件夹中。当这两个文件夹中有同名文件时，用户级配置优先。Extension Manager?将文件安装到"User"配置文件夹中。 所有用户级配置文件夹 "All Users"配置文件夹包含"HelpPanel"文件夹，后者又包含驱动"帮助"面板的文件。这些文件可位于"All Users"配置文件夹和"User"配置文件夹中。当这两个文件夹中有同一书名时，"User"配置文件夹优先。Extension Manager?将文件安装到"User"配置文件夹中。 |
