Document 对象

可用性

Flash MX 2004。

说明

Document 对象表示舞台。即只有 FLA 文件才被视为文档。若要返回当前文档的 Document 对象，请使用 fl.getDocumentDOM()。

Document 对象的方法摘要

您可以使用 Document 对象的以下方法：

方法	描述
`document.addDataToDocument()`	将指定的数据存储在文档中。
`document.addDataToSelection()`	将指定的数据存储在所选对象中。
`document.addFilter()`	向所选对象应用滤镜。
`document.addItem()`	从任何打开的文档或库将一个项目添加到指定的文档对象。
`document.addNewLine()`	在两点之间添加一个新路径。
`document.addNewOval()`	在指定的边界矩形中添加一个新 Oval 对象。
`document.addNewPublishProfile()`	添加新的发布配置文件，并用作当前发布配置文件。
`document.addNewRectangle()`	添加一个新的矩形或圆角矩形，并使其适应指定的范围。
`document.addNewScene()`	添加一个新场景（Timeline 对象），作为当前所选场景之后的下一个场景，并将该新场景作为当前所选场景。
`document.addNewText()`	插入一个新的空文本字段。
`document.align()`	对齐所选内容。
`document.allowScreens()`	在使用 `document.screenOutline` 属性之前，应先使用此方法。
`document.arrange()`	排列舞台上的所选内容。
`document.breakApart()`	对当前所选内容执行分离操作。
`document.canEditSymbol()`	指示是否已启用"编辑元件"菜单和功能。
`document.canRevert()`	确定是否可以成功使用 `document.revert()` 或 fl.revertDocument() 方法。
`document.canSaveAVersion()`	确定是否可以将某一版本的指定文档保存到 Version Cue 服务器。
`document.canTestMovie()`	确定是否可以成功使用 `document.testMovie()` 方法。
`document.canTestScene()`	确定是否可以成功使用 `document.testScene()` 方法。
`document.changeFilterOrder()`	更改滤镜列表中的滤镜索引。
`document.clipCopy()`	将当前所选内容从文档复制到剪贴板。
`document.clipCut()`	从文档中剪切当前所选内容，并将其写入剪贴板。
`document.clipPaste()`	将剪贴板的内容粘贴到文档中。
`document.close()`	关闭指定的文档。
`document.convertLinesToFills()`	将所选对象上的线条转换为填充。
`document.convertToSymbol()`	将所选舞台项目转换为一个新元件。
`document.crop()`	使用最上面的所选绘制对象裁剪在其下面的所有选定的绘制对象。
`document.deleteEnvelope()`	从所选对象删除封套（包含一个或多个对象的边框）。
`document.deletePublishProfile()`	如果存在多个配置文件，则删除当前活动配置文件。
`document.deleteScene()`	删除当前场景（Timeline 对象），如果删除的场景不是最后一个场景，则将下一个场景设置为当前 Timeline 对象。
`document.deleteSelection()`	删除舞台上的当前所选内容。
`document.disableAllFilters()`	禁用所选对象上的所有滤镜。
`document.disableFilter()`	禁用滤镜列表中的指定滤镜。
`document.disableOtherFilters()`	禁用滤镜列表中指定位置之外的所有滤镜。
`document.distribute()`	分散所选内容。
`document.distributeToLayers()`	对当前所选内容执行分散到图层操作，此操作等效于选择"分散到图层"。
`document.documentHasData()`	检查文档中是否存在具有指定名称的永久数据。
`document.duplicatePublishProfile()`	直接复制当前活动配置文件，并提供直接复制版本焦点。
`document.duplicateScene()`	制作当前所选场景的副本，为该新场景提供一个唯一的名称，并将它作为当前场景。
`document.duplicateSelection()`	直接复制舞台上的所选内容。
`document.editScene()`	将指定场景作为当前所选场景以进行编辑。
`document.enableAllFilters()`	为所选对象启用"滤镜"列表上的所有滤镜。
`document.enableFilter()`	为所选对象启用指定的滤镜。
`document.enterEditMode()`	将创作工具切换到由参数指定的编辑模式。
`document.exitEditMode()`	退出元件编辑模式，并将焦点返回编辑模式的上一级。
`document.exportPNG()`	将文档导出为一个或多个 PNG 文件。
`document.exportPublishProfile()`	将当前活动配置文件导出到 XML 文件中。
`document.exportSWF()`	以 Flash SWF 格式导出文档。
`document.getAlignToDocument()`	与检索"对齐"面板中"相对于舞台"按钮的值相同。
`document.getBlendMode()`	返回一个字符串，为选中的对象指定混合模式。
`document.getCustomFill()`	检索所选形状的填充对象，或者检索"工具"面板和"属性"检查器的填充对象（如果指定）。
`document.getCustomStroke()`	返回所选形状的笔触对象，或者返回"工具"面板和"属性"检查器的笔触对象（如果指定）。
`document.getDataFromDocument()`	检索指定数据的值。
`document.getElementProperty()`	获取当前所选内容的指定 `Element` 属性。
`document.getElementTextAttr()`	获取所选 Text 对象的指定 `TextAttrs` 属性。
`document.getFilters()`	返回一个数组，它包含应用于当前所选对象的滤镜的列表。
`document.getMetadata()`	返回一个字符串，其中包含与文档关联的 XML 元数据。
`document.getMobileSettings()`	返回传递给 `document.setMobileSettings()` 的字符串。
`document.getPlayerVersion()`	返回表示指定文档的目标播放器版本的字符串。
`document.getSelectionRect()`	获取当前所选内容的边界矩形。
`document.getTextString()`	获取当前所选文本。
`document.getTimeline()`	检索文档中的当前 Timeline 对象。
`document.getTransformationPoint()`	获取当前所选内容的变形点的位置。
`document.group()`	将当前所选内容转换为一组。
`document.importFile()`	将一个文件导入文档。
`document.importPublishProfile()`	从文件导入配置文件。
`document.importSWF()`	将一个 SWF 文件导入文档。
`document.intersect()`	从所有所选绘制对象创建一个交集绘制对象。
`document.match()`	使所选对象的大小相同。
`document.mouseClick()`	从"选择"工具执行鼠标单击。
`document.mouseDblClk()`	从"选择"工具执行鼠标双击。
`document.moveSelectedBezierPointsBy()`	如果所选内容至少包含一个路径，并且这些路径都至少选择了一个贝塞尔曲线点，则此方法会按照指定的量移动所有所选路径上的全部所选贝塞尔曲线点。
`document.moveSelectionBy()`	按照指定的距离移动所选对象。
`document.optimizeCurves()`	优化当前所选内容的平滑，允许多重过渡（如果指定）以实现最佳平滑；等效于选择"修改">"形状">"优化"。
`document.publish()`	按照活动的"发布设置"（"文件">"发布设置"）发布文档；等效于选择"文件">"发布"。
`document.punch()`	使用所选的最上面的绘制对象对在其下面选择的所有绘制对象打孔。
`document.removeAllFilters()`	从所选对象中删除所有滤镜。
`document.removeDataFromDocument()`	删除附加到文档、具有指定名称的永久数据。
`document.removeDataFromSelection()`	删除附加到所选内容、具有指定名称的永久数据。
`document.removeFilter()`	从所选对象的"滤镜"列表中删除指定的滤镜。
`document.renamePublishProfile()`	重命名当前配置文件。
`document.renameScene()`	在"场景"面板中重命名当前所选场景。
`document.reorderScene()`	将指定场景移动到另一个指定场景前面。
`document.resetOvalObject()`	将"属性"检查器中的所有值设置为默认的 Oval 对象设置。
`document.resetRectangleObject()`	将"属性"检查器中的所有值设置为默认的 Rectangle 对象设置。
`document.resetTransformation()`	重置变形矩阵；等效于选择"修改">"变形">"删除变形"。
`document.revert()`	将指定文档回复到以前保存的版本；等效于选择"文件">"回复"。
`document.revertToLastVersion()`	将指定文档还原为 Version Cue 服务器上存储的版本，并将所有错误记录至"输出"面板。
`document.rotateSelection()`	按照指定度数旋转所选内容。
`document.save()`	将文档保存在其默认位置；等效于选择"文件">"保存"。
`document.saveAndCompact()`	保存并压缩文件；等效于选择"文件">"保存并压缩"。
`document.saveAVersion()`	将某一版本的指定文档保存到 Version Cue 服务器。
`document.scaleSelection()`	按照指定的量缩放所选内容；等效于使用"任意变形"工具缩放对象。
`document.selectAll()`	选择舞台上的所有项目；等效于按 Control+A (Windows) 或 Command+A (Macintosh)，也等效于选择"编辑">"全选"。
`document.selectNone()`	取消选择全部被选定的项目。
`document.setAlignToDocument()`	将 `document.align()`、`document.distribute()`、`document.match()` 和 `document.space()` 的首选参数设置为针对文档进行操作；等效于在"对齐"面板中启用"相对于舞台"按钮。
`document.setBlendMode()`	设置所选对象的混合模式。
`document.setCustomFill()`	设置"工具"面板、"属性"检查器和全部所选形状的填充设置。
`document.setCustomStroke()`	设置"工具"面板、"属性"检查器和全部所选形状的笔触设置。
`document.setElementProperty()`	设置文档中所选对象的指定 `Element` 属性。
`document.setElementTextAttr()`	将所选文本项的指定 `TextAttrs` 属性设置为指定值。
`document.setFillColor()`	将所选内容的填充颜色更改为指定的颜色。
`document.setFilterProperty()`	设置当前所选对象的指定滤镜属性。
`document.setFilters()`	将滤镜应用于所选对象。
`document.setInstanceAlpha()`	设置实例的不透明度。
`document.setInstanceBrightness()`	设置实例的亮度。
`document.setInstanceTint()`	设置实例的色调。
`document.setMetadata()`	设置指定文档的 XML 元数据，覆盖全部现有元数据。
`document.setMobileSettings()`	设置移动 FLA 文件中 XML 设置字符串的值。
`document.setOvalObjectProperty()`	为 Oval 图元对象的指定属性指定值。
`document.setPlayerVersion()`	设置指定文档的目标 Flash Player 的版本。
`document.setRectangleObjectProperty()`	为 Rectangle 图元对象的指定属性指定值。
`document.setSelectionBounds()`	在单个操作中移动所选内容并调整其大小。
`document.setSelectionRect()`	使用指定坐标绘制相对于舞台的矩形选取框。
`document.setStroke()`	设置所选笔触的颜色、宽度和样式。
`document.setStrokeColor()`	将所选内容的笔触颜色更改为指定的颜色。
`document.setStrokeSize()`	将所选内容的笔触大小更改为指定的大小。
`document.setStrokeStyle()`	将所选内容的笔触样式更改为指定的样式。
`document.setTextRectangle()`	将所选文本项目的边框矩形更改为指定的大小。
`document.setTextSelection()`	将当前所选文本字段中的所选文本设置为由 `startIndex` 和 `endIndex` 值指定的值。
`document.setTextString()`	插入文本字符串。
`document.setTransformationPoint()`	移动当前所选内容的变形点。
`document.skewSelection()`	按照指定的量倾斜所选内容。
`document.smoothSelection()`	平滑所选的每条填充轮廓或弯曲线的曲线。
`document.space()`	均匀间隔所选内容中的对象。
`document.straightenSelection()`	伸直当前所选笔触；等效于使用"工具"面板中的"伸直"按钮。
`document.swapElement()`	用指定的选择内容交换当前选择内容。
`document.swapStrokeAndFill()`	交换笔触和填充颜色。
`document.synchronizeWithHeadVersion()`	使指定文档与 Version Cue 服务器上的最新版本同步，并将所有错误记录至"输出"面板。
`document.testMovie()`	对文档执行"测试影片"操作。
`document.testScene()`	对文档的当前场景执行"测试场景"操作。
`document.traceBitmap()`	对当前所选内容执行跟踪位图；等效于选择"修改">"位图">"跟踪位图"。
`document.transformSelection()`	通过应用参数中指定的矩阵，对当前所选内容执行常规变形。
`document.unGroup()`	取消组合当前所选内容。
`document.union()`	将所有所选形状合并到一个绘制对象中。
`document.unlockAllElements()`	解除锁定当前所选帧上的全部锁定元素。
`document.xmlPanel()`	张贴 XMLUI 对话框。

Document 对象的属性摘要

您可以使用 Document 对象的以下属性。

属性	描述
`document.accName`	一个字符串，它等效于"辅助功能"面板中的"名称"字段。
`document.as3AutoDeclare`	一个布尔值，它说明是否将放置在舞台上的实例自动添加到用户定义的时间轴类中。
`document.as3Dialect`	一个字符串，它描述指定文档中使用的 ActionScript 3.0 术语。
`document.as3ExportFrame`	一个整数，它指定在哪一帧导出 ActionScript 3.0 类。
`document.as3StrictMode`	一个布尔值，它指定 ActionScript 3.0 编译器在进行编译时是打开还是关闭"严格模式"选项。
`document.as3WarningsMode`	一个布尔值，它指定 ActionScript 3.0 编译器在进行编译时是打开还是关闭"警告模式"选项。
`document.asVersion`	一个整数，它指定在指定文件中使用 ActionScript 的哪一版本。
`document.autoLabel`	一个布尔值，它等效于"辅助功能"面板中的"自动标签"复选框。
`document.backgroundColor`	一个字符串、十六进制值或整数，它表示背景的颜色。
`document.currentPublishProfile`	一个字符串，它为指定文档的活动发布配置文件指定名称。
`document.currentTimeline`	一个整数，它指定活动时间轴的索引。
`document.description`	一个字符串，它等效于"辅助功能"面板中的"描述"字段。
`document.docClass`	指定与文档关联的顶级 ActionScript 3.0 类。
`document.forceSimple`	一个布尔值，它指定是否可以访问指定对象的子项。
`document.frameRate`	一个浮点值，它指定播放 SWF 文件时每秒显示的帧数；默认值为 12。
`document.height`	一个整数，它以像素为单位指定文档（舞台）的高度。
`document.id`	一个（自动分配的）唯一整数，用于在 Flash 会话期间标识文档。
`document.library`	只读；文档的 library 对象。
`document.livePreview`	一个布尔值，它指定是否启用"实时预览"。
`document.name`	只读；一个字符串，它表示文档（FLA 文件）的名称。
`document.path`	只读；一个字符串，它表示文档的路径。
`document.publishProfiles`	只读；文档的发布配置文件名称的数组。
`document.screenOutline`	只读；文档的当前 ScreenOutline 对象。
`document.selection`	文档中所选对象的数组。
`document.silent`	一个布尔值，它指定对象是否可访问。
`document.timelines`	只读；由 Timeline 对象组成的数组（请参阅 Timeline 对象）。
`document.viewMatrix`	只读；一个 Matrix 对象。
`document.width`	一个整数，它以像素为单位指定文档（舞台）的宽度。
`document.zoomFactor`	指定创作时舞台的缩放百分比。

查看 LiveDocs 上的注释