_accProps

可用性

Flash Player 6 版本 65。

用法

_accProps.propertyName
instanceName._accProps.propertyName

参数

propertyName 辅助功能属性名（请参见以下有关有效名称的说明）。

instanceName 分配给影片剪辑、按钮、动态文本字段或输入文本字段的实例的实例名称。

说明

属性；用于在运行时控制 SWF 文件、影片剪辑、按钮、动态文本字段或输入文本字段的屏幕读取器辅助功能选项。这些属性覆盖创作时在“辅助功能”面板中提供的相应设置。为使对这些属性的更改生效，您必须调用 Accessibility.updateProperties()。有关“辅助功能”面板的信息，请参见Flash 的“辅助功能”面板。

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

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

^* 有关向可访问对象分配快捷键的信息，请参见 Key.addListener()。

若要在“辅助功能”面板中指定与 Tab 键索引设置相对应的设置，请使用 Button.tabIndex、
MovieClip.tabIndex 或 TextField.tabIndex 属性。

无法在运行时指定“自动标签”设置。

如果使用时未采用 instanceName 参数，则对 _accProps 属性的更改将应用于整个影片。例如，以下代码将整个影片的辅助功能 name 属性设置为字符串 "Pet Store"，然后调用
Accessibility.updateProperties() 来使所作更改生效。

_accprops.name = "Pet Store";
Accessbility.updateProperties();

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

price_mc._accProps.name = "Price";
Accessbility.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";
Accessbility.updateProperties();

如果您没有指定影片或对象的辅助功能属性，则实现在“辅助功能”面板中设置的任何值。

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

my_mc._accProps.silent = true; // 设置属性
// 此处为其它代码
delete my_mc._accProps.silent; // 还原为默认值

若要将一个对象的所有辅助功能值都还原为默认值，可以删除 instanceName._accProps 对象：

deletemy_btn._accProps; 

若要将所有对象的辅助功能值都还原为默认值，可以删除全局 _accProps 对象：

delete _accProps;

如果您把某一属性指定给不支持该属性的对象类型，那么该属性指定将被忽略，不会引发任何错误。例如，按钮不支持 forceSimple 属性，因此忽略如下行：

my_btn._accProps.forceSimple = false; //ignored

示例

下面是某些利用动态辅助功能属性的示例动作脚本代码。您应将该代码分配给可以更改其显示的图标的非文本图标按钮组件。

function setIcon( newIconNum, newTextEquivalent )
{
   this.iconImage = this.iconImages[ newIconNum ];
   if ( newTextEquivalent != undefined )
   {
      if ( this._accProps == undefined )
         this._accProps = new Object();
      this._accProps.name = newTextEquivalent;
      Accessibility.updateProperties();
   }
}

另请参见

Accessibility.isActive()、Accessibility.updateProperties()、
System.capabilities.hasAccessibility