_accProps 属性

_accProps.propertyName
instanceName._accProps.propertyName

允许您在运行时控制 SWF 文件、影片剪辑、按钮、动态文本字段和输入文本字段的屏幕读取器辅助功能选项。这些属性将覆盖创作过程中在"辅助功能"面板中可用的相应设置。为使对这些属性的更改生效，您必须调用 Accessibility.updateProperties()。

有关"辅助功能"面板的信息，请参阅《使用 Flash》中的"Flash 辅助功能面板"。

若要确定播放器是否运行在支持辅助功能的环境中，请使用 System.capabilities.hasAccessibility 属性。

下表列出了每个 _accProps 属性的名称和数据类型、它在"辅助功能"面板中的等效设置以及可以应用该属性的对象类型。术语反逻辑 是指该属性设置与"辅助功能"面板中的相应设置相反。例如，将 silent 属性设置为 true 等于取消选择"使影片可访问"或"使对象可访问"选项。

属性

数据类型

"辅助功能"面板中的等效设置

应用于

silent

Boolean

使影片可访问/使对象可访问（反逻辑）

整个 SWF 文件、影片剪辑、按钮、动态文本和输入文本

forceSimple

Boolean

使子对象可访问（反逻辑）

整个 SWF 文件和影片剪辑

name

String

名称

整个 SWF 文件、影片剪辑、按钮和输入文本

description

String

说明

整个 SWF 文件、影片剪辑、按钮、动态文本和输入文本

shortcut

String

快捷键

影片剪辑、按钮、输入文本

属性	数据类型	"辅助功能"面板中的等效设置	应用于
`silent`	Boolean	使影片可访问/使对象可访问（反逻辑）	整个 SWF 文件、影片剪辑、按钮、动态文本和输入文本
`forceSimple`	Boolean	使子对象可访问（反逻辑）	整个 SWF 文件和影片剪辑
`name`	String	名称	整个 SWF 文件、影片剪辑、按钮和输入文本
`description`	String	说明	整个 SWF 文件、影片剪辑、按钮、动态文本和输入文本
`shortcut`	String	快捷键	影片剪辑、按钮、输入文本

对于"快捷键"字段，应使用 Ctrl+A 格式的名称。向"辅助功能"面板添加一个键盘快捷键不会创建键盘快捷键；它只会向屏幕读取器告知现有快捷键。有关向辅助对象分配快捷键的信息，请参阅 Key.addListener()。

若要指定对应于"辅助功能"面板中的"选项卡"索引设置的设置，请使用 Button.tabIndex、MovieClip.tabIndex 或 TextField.tabIndex 属性。

若要引用表示整个 Flash 文档的 _accProps 对象，请省略 instanceName 参数。_accProps 的值必须是一个对象。这表示如果不存在 _accProps 对象，则您必须创建一个对象，才能为 _accProps 对象的属性分配值，如下面的示例所示：


if ( _accProps == undefined ) 
{ 
 _accProps = new Object(); 
} 
_accProps.name = "My SWF file";

使用不带 instanceName 参数的 _accProps 时，对 _accProps 属性所做的更改会应用于整个 SWF 文件。例如，下面的代码将整个 SWF 文件的辅助功能 name 属性设置为字符串 "Pet Store"，然后调用 Accessibility.updateProperties() 来促成该更改：

_accProps.name = "Pet Store"; 
Accessibility.updateProperties();

相反，下面的代码将实例名称为 price_mc 的影片剪辑的 name 属性设置为字符串 "Price"：

price_mc._accProps.name = "Price";
Accessibility.updateProperties();

如果您要指定若干辅助功能属性，则应在调用 Accessibility.updateProperties() 前进行尽可能多的更改，而不是在每个属性语句后调用它，如下面的示例所示：

_accProps.name = "Pet Store";

animal_mc._accProps.name = "Animal"; 
animal_mc._accProps.description = "Cat, dog, fish, etc.";

price_mc._accProps.name = "Price";
price_mc._accProps.description = "Cost of a single item";

Accessibility.updateProperties();

如果您没有指定文档或对象的辅助功能属性，则实现在"辅助功能"面板中设置的任意值。

在指定一个辅助功能属性后，就不能将它"辅助功能"的值还原为在"辅助功能"面板中设置的值。但是，可以通过从 _accProps 对象删除属性将该属性设置为其默认值（布尔值为 false；字符串值为空字符串），如下面的示例所示：

 my_mc._accProps.silent = true; // set a property 
// other code here 
delete my_mc._accProps.silent; // revert to default value

参数

propertyName:BooleanorString ― 辅助功能属性名（请参阅以下有关有效名称的说明）。instanceName

instanceName:String ― 分配给影片剪辑、按钮、动态文本字段或输入文本字段的实例的实例名称。若要引用表示整个 Flash 文档的 _accProps 对象，请省略 instanceName。

示例

如果更改某个图像并且想要更新它的辅助功能说明，可以使用以下 ActionScript 代码：

my_mc.gotoAndStop(2);

if (my_mc._accProps == undefined ) {
 my_mc._accProps = new Object();
}

my_mc._accProps.name = "Photo of Mount Rushmore";
Accessibility.updateProperties();