Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: AIR 30.0 e anterior, Flash Player 30.0 e anterior, Flash Lite 4
Flex 4.6 e anterior, Flash Pro CS6 e anterior
Ocultar filtros
fl.managers 

IFocusManagerComponent  - AS3 Flash

Pacotefl.managers
Interfacepublic interface IFocusManagerComponent
Implementadores Button, ColorPicker, ComboBox, DataGrid, LabelButton, List, NumericStepper, ScrollPane, SelectableList, Slider, TextArea, TextInput, TileList

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

A interface IFocusManagerComponent fornece métodos e propriedades que dão aos componentes a capacidade de receber foco. Os componentes devem implementar essa interface para receber foco do FocusManager.

A classe UIComponent fornece uma implementação básica dessa interface mas não a implementa completamente pois nem todos os objetos UIComponent recebem foco. Os componentes que são derivados da classe UIComponent devem implementar essa interface para serem capazes de receber foco. Para ativar o foco, adicione a instrução implements IFocusManagerComponent à definição da classe de um componente que seja derivada da classe UIComponent.

Elementos da API relacionados



Propriedades públicas
 PropriedadeDefinido por
  focusEnabled : Boolean
Obtém ou define um valor booliano que indica se um componente selecionado pode receber foco do gerenciador de foco.
IFocusManagerComponent
  mouseFocusEnabled : Boolean
[somente leitura] Obtém um valor booliano que indica se um componente selecionado com o uso de um dispositivo de mouse pode receber foco.
IFocusManagerComponent
  tabEnabled : Boolean
[somente leitura] Obtém um valor booliano que indica se pressionar a tecla Tab pode deslocar o foco até esse componente.
IFocusManagerComponent
  tabIndex : int
[somente leitura] Obtém a ordem na qual o componente recebe foco, se tabEnabledis estiver definido como verdadeiro.
IFocusManagerComponent
Métodos públicos
 MétodoDefinido por
  
Desenha um indicador de foco visual.
IFocusManagerComponent
  
Define o foco para um componente.
IFocusManagerComponent
Detalhes da propriedade

focusEnabled

propriedade
focusEnabled:Boolean

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém ou define um valor booliano que indica se um componente selecionado pode receber foco do gerenciador de foco.

Para tornar um componente capaz de receber foco do gerenciador de foco, defina essa propriedade como true. Para tornar um componente incapaz de receber foco, defina essa propriedade como false. Quando focusEnabled está definido como false, o gerenciador de foco ignora o componente durante a vida útil do componente e não o monitora quanto a alterações nas seguintes propriedades: tabEnabled, tabChildren e mouseFocusEnabled.

Você pode usar a propriedade focusEnabled para impedir que o componente-filho de um componente que implementa a interface IFocusManagerComponent receba foco do gerenciador de foco. Para isso, defina essa propriedade como false antes de usar o método addChild() para adicionar o componente-filho à lista de exibição. Observe que, se você define essa propriedade como false antes de adicionar o componente à lista de exibição, o gerenciador de foco continua a ignorar o componente mesmo que, posteriormente, você defina essa propriedade como true.

Observação: Mesmo que você defina essa propriedade como false, ainda poderá definir o foco programaticamente usando o método setFocus().



Implementação
    public function get focusEnabled():Boolean
    public function set focusEnabled(value:Boolean):void

mouseFocusEnabled

propriedade 
mouseFocusEnabled:Boolean  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém um valor booliano que indica se um componente selecionado com o uso de um dispositivo de mouse pode receber foco.

Defina essa propriedade como true para dar foco a componentes que são selecionados usando um dispositivo de mouse. Defina essa propriedade como false para impedir que seja dado foco a componentes que são selecionados usando um dispositivo de mouse. Se essa propriedade for definida como false quando um componente é selecionado usando um dispositivo de mouse, o foco será transferido ao primeiro componente-pai ao qual essa propriedade está definida como true.



Implementação
    public function get mouseFocusEnabled():Boolean

tabEnabled

propriedade 
tabEnabled:Boolean  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém um valor booliano que indica se pressionar a tecla Tab pode deslocar o foco até esse componente. Um valor de true indica que o pressionamento da tecla Tab pode fazer com que o foco seja movido dessa componente; um valor de false indica que a tecla Tab não pode ser usada para dar foco a esse componente.

Mesmo se esse valor estiver definido como false, o componente ainda poderá receber foco quando for selecionado por um dispositivo de mouse ou por meio de uma chamada do método setFocus().



Implementação
    public function get tabEnabled():Boolean

tabIndex

propriedade 
tabIndex:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Obtém a ordem na qual o componente recebe foco, se tabEnabled estiver definido como true. A propriedade tabIndex é -1 por padrão, significando que nenhum índice de tabulação está definido para o objeto e que o objeto recebe foco com base na ordem z.

A propriedade tabIndex também pode ser um número inteiro negativo. Nesse caso, os objetos são ordenados de acordo com suas propriedades tabIndex, na ordem ascendente. Um objeto com um valor tabIndex de 1 precede um objeto com um valor tabIndex de 2. Se dois objetos têm o mesmo valor tabIndex, aquele que vem primeiro na ordem de tabulação padrão precede o outro.

O valor padrão é -1.



Implementação
    public function get tabIndex():int
Detalhes do método

drawFocus

()método
public function drawFocus(draw:Boolean):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Desenha um indicador de foco visual.

Esse método é chamado pelo gerenciador de foco quando o componente recebe foco. O componente deverá desenhar ou ocultar um gráfico que indica se o componente tem foco.

Parâmetros

draw:Boolean — Se true, desenhe o indicador de foco; caso contrário, oculte-o.

setFocus

()método 
public function setFocus():void

Versão da linguagem: ActionScript 3.0
Versão de produto: Flash CS3
Versões de runtime: Flash Player 9.0.28.0, AIR 1.0

Define o foco para um componente.

Esse método é chamado pelo gerenciador de foco quando o componente recebe foco. O componente, por sua vez, pode definir um foco em um componente interno.





[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.