| 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):voidmouseFocusEnabled | 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():BooleantabEnabled | 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():BooleantabIndex | 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():intdrawFocus | () | 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