Pacote | flash.accessibility |
Classe | public class AccessibilityProperties |
Herança | AccessibilityProperties Object |
Subclasses | UIComponentAccImpl, UIComponentAccProps |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Você pode anexar um objeto AccessibilityProperties a qualquer objeto de exibição, mas o Flash Player lerá seu objeto AccessibilityProperties somente para determinados tipos de objetos: arquivos SWF inteiros (conforme representando por DisplayObject.root
), objetos de contêiner (DisplayObjectContainer
e subclasses), botões (SimpleButton
e subclasses) e texto (TextField
e subclasses).
A propriedade name
desses objetos é a propriedade mais importante a ser especificada pois os auxílios de acessibilidade fornecem os nomes dos objetos aos usuários como um meio básico de navegação. Não confunda AccessibilityProperties.name
com DisplayObject.name
; são propriedades separadas e não relacionadas. A propriedade AccessibilityProperties.name
é um nome que é lido em voz alta pelos auxílios de acessibilidade, onde DisplayObject.name
é, essencialmente, um nome de variável visível somente ao código ActionScript.
No Flash Professional, as propriedades dos objetos AccessibilityProperties
substituem as configurações correspondentes disponíveis no painel Acessibilidade durante a autoria.
Para determinar se o Flash Player está sendo executado em um ambiente que suporta auxílios de acessibilidade, use a propriedade Capabilities.hasAccessibility
. Se você modificar objetos AccessibilityProperties, precisará chamar o método Accessibility.updateProperties()
para que as alterações tenham efeito.
Elementos da API relacionados
flash.display.DisplayObject.accessibilityProperties
flash.display.InteractiveObject.tabIndex
flash.system.Capabilities.hasAccessibility
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
description : String
Fornece uma descrição para este objeto de exibição na apresentação acessível. | AccessibilityProperties | ||
forceSimple : Boolean
Se for verdadeiro, fará com que o Flash Player exclua da apresentação acessível os objetos-filho dentro deste objeto de exibição. | AccessibilityProperties | ||
name : String
Fornece um nome para este objeto de exibição na apresentação acessível. | AccessibilityProperties | ||
noAutoLabeling : Boolean
Se true, desativará o sistema de rotulação automática padrão do Flash Player. | AccessibilityProperties | ||
shortcut : String
Indica um atalho de teclado associado a este objeto de exibição. | AccessibilityProperties | ||
silent : Boolean
Se true, excluirá o objeto de exibição da apresentação acessível. | AccessibilityProperties |
Método | Definido por | ||
---|---|---|---|
Cria um novo objeto CameraRollBrowseOptions. | AccessibilityProperties | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object |
description | propriedade |
public var description:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Fornece uma descrição para este objeto de exibição na apresentação acessível. Se você muitas informações a apresentar sobre o objeto, é melhor escolher um nome conciso e colocar a maior parte de seu conteúdo na propriedade description
. Aplica-se a arquivos SWF completos, contêineres, botões e texto. O valor padrão é uma string vazia.
No Flash Professional, esta propriedade equivale ao campo Descrição do painel Acessibilidade.
forceSimple | propriedade |
public var forceSimple:Boolean
Versões de runtime: | AIR 1.0, Flash Player 9 |
Se true
, fará com que o Flash Player exclua da apresentação acessível os objetos-filho dentro desse objeto de exibição. O padrão é false
. Aplica-se a arquivos SWF completos e contêineres.
name | propriedade |
public var name:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Fornece um nome para este objeto de exibição na apresentação acessível. Aplica-se a arquivos SWF completos, contêineres, botões e texto. Não confunda com DisplayObject.name
, que é não relacionado. O valor padrão é uma string vazia.
No Flash Professional, esta propriedade equivale ao campo Nome do painel de Acessibilidade.
noAutoLabeling | propriedade |
public var noAutoLabeling:Boolean
Versões de runtime: | AIR 1.0, Flash Player 9 |
Se true
, desativará o sistema de rotulação automática padrão do Flash Player. O rotulamento automático faz com que os objetos dentro de botões sejam tratados como nomes de botões, e os objetos de texto próximos a campos de texto sejam tratados como nomes de campo de texto. O padrão é false
. Aplica-se somente a arquivos SWF completos.
O valor da propriedade noAutoLabeling
é ignorado a não ser que você o especifique antes da primeira vez que um auxílio de acessibilidade examine seu arquivo SWF. Se você planeja definir noAutoLabeling
como true
, deverá fazer isso o mais cedo possível em seu código.
shortcut | propriedade |
public var shortcut:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica um atalho de teclado associado a este objeto de exibição. Forneça essa string somente para controles da IU que você tenha associado a uma tecla de atalho. Aplica-se a contêineres, botões e texto. O valor padrão é uma string vazia.
Observação: Atribuir essa propriedade não atribui automaticamente a combinação de teclas especificada para esse objeto; você mesmo deve fazer isso, por exemplo, ouvindo um KeyboardEvent
.
A sintaxe para essa string usa nomes longos para teclas do modificador, e o sinal de mais (+) para indicar a combinação de teclas. Exemplos de strings válidas são "Ctrl+F", "Ctrl+Shift+Z" etc.
silent | propriedade |
public var silent:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Se true
, excluirá o objeto de exibição da apresentação acessível. O padrão é false
. Aplica-se a arquivos SWF completos, contêineres, botões e texto.
AccessibilityProperties | () | Construtor |
public function AccessibilityProperties()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Cria um novo objeto CameraRollBrowseOptions.
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
e ButtonDisplayState
para criar um menu compatível com acessibilidade que funcione com os leitores de tela mais comuns. A funcionalidade principal da classe AccessibilityProperties
é a seguinte:
- Chame
configureAssets
, o que cria um botão personalizado e define seu rótulo e sua descrição. Esses são os valores que o leitor de tela transmite ao usuário final. - Chame
setTimeOut()
para garantir que o Flash Player tenham tempo suficiente para detectar o leitor de tela antes de atualizar as propriedades.
Observação: Chame setTimeout()
antes de marcar Accessibility.active
. para dar ao Flash Player os 2 segundos que ele necessita para conectar a um leitor de tela, se houver um disponível. Se você não fornecer um tempo de atraso suficiente, a chamada de setTimeout
poderá retornar false
mesmo que um leitor de tela esteja disponível.
O exemplo a seguir processa o método Accessibility.updateProperties()
somente se a chamada de Accessibility.active
retornar true
, o que só ocorre se o Flash Player estiver conectado a um leitor de tela ativo no momento. Se updateProperties
for chamado sem um leitor de tela ativo, ele lançará uma exceção IllegalOperationError
.
package { import flash.display.Sprite; import flash.accessibility.Accessibility; import flash.utils.setTimeout; public class AccessibilityPropertiesExample extends Sprite { public static const BUTTON_WIDTH:uint = 90; public static const BUTTON_HEIGHT:uint = 20; private var gutter:uint = 5; private var menuLabels:Array = new Array("PROJECTS", "PORTFOLIO", "CONTACT"); private var menuDescriptions:Array = new Array("Learn more about our projects" , "See our portfolio" , "Get in touch with our team"); public function AccessibilityPropertiesExample() { configureAssets(); setTimeout(updateAccessibility, 2000); } private function updateAccessibility():void { trace("Accessibility.active: " + Accessibility.active); if(Accessibility.active) { Accessibility.updateProperties(); } } private function configureAssets():void { var child:CustomAccessibleButton; for(var i:uint; i < menuLabels.length; i++) { child = new CustomAccessibleButton(); child.y = (numChildren * (BUTTON_HEIGHT + gutter)); child.setLabel(menuLabels[i]); child.setDescription(menuDescriptions[i]); addChild(child); } } } import flash.accessibility.AccessibilityProperties; import flash.display.Shape; import flash.display.SimpleButton; import flash.display.Sprite; import flash.events.Event; import flash.text.TextFormat; import flash.text.TextField; class CustomAccessibleButton extends Sprite { private var button:SimpleButton; private var label1:TextField; private var description:String; private var _name:String; public function CustomAccessibleButton(_width:uint = 0, _height:uint = 0) { _width = (_width == 0) ? AccessibilityPropertiesExample.BUTTON_WIDTH : _width; _height = (_height == 0) ? AccessibilityPropertiesExample.BUTTON_HEIGHT : _height; button = buildButton(_width, _height); label1 = buildLabel(_width, _height); addEventListener(Event.ADDED, addedHandler); } private function addedHandler(event:Event):void { trace("addedHandler: " + name); var accessProps:AccessibilityProperties = new AccessibilityProperties(); accessProps.name = this._name; accessProps.description = description; accessibilityProperties = accessProps; removeEventListener(Event.ADDED, addedHandler); } private function buildButton(_width:uint, _height:uint):SimpleButton { var child:SimpleButton = new CustomSimpleButton(_width, _height); addChild(child); return child; } private function buildLabel(_width:uint, _height:uint):TextField { var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.size = 11; format.color = 0xFFFFFF; format.align = TextFormatAlign.CENTER; format.bold = true; var child:TextField = new TextField(); child.y = 1; child.width = _width; child.height = _height; child.selectable = false; child.defaultTextFormat = format; child.mouseEnabled = false; addChild(child); return child; } public function setLabel(text:String):void { label1.text = text; this._name = text; } public function setDescription(text:String):void { description = text; } } class CustomSimpleButton extends SimpleButton { private var upColor:uint = 0xFFCC00; private var overColor:uint = 0xCCFF00; private var downColor:uint = 0x00CCFF; public function CustomSimpleButton(_width:uint, _height:uint) { downState = new ButtonDisplayState(downColor, _width, _height); overState = new ButtonDisplayState(overColor, _width, _height); upState = new ButtonDisplayState(upColor, _width, _height); hitTestState = new ButtonDisplayState(upColor, _width, _height); useHandCursor = true; } } class ButtonDisplayState extends Shape { private var bgColor:uint; private var _width:uint; private var _height:uint; public function ButtonDisplayState(bgColor:uint, _width:uint, _height:uint) { this.bgColor = bgColor; this._width = _width; this._height = _height; draw(); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(0, 0, _width, _height); graphics.endFill(); } } }
Wed Jun 13 2018, 11:10 AM Z