Pacote | fl.managers |
Interface | public 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 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
Propriedade | Definido 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étodo | Definido por | ||
---|---|---|---|
Desenha um indicador de foco visual. | IFocusManagerComponent | ||
Define o foco para um componente. | IFocusManagerComponent |
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
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.
Wed Jun 13 2018, 11:10 AM Z