| Pacchetto | fl.managers |
| Classe | public class FocusManager |
| Ereditarietà | FocusManager Object |
| Implementa | IFocusManager |
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Un ciclo di tabulazioni viene generalmente navigato mediante il tasto Tab; l'attivazione passa da un componente all'altro nel ciclo di tabulazioni seguendo uno schema circolare a partire dal primo componente attivato, fino all'ultimo, per ritornare di nuovo al primo. Un ciclo di tabulazioni include tutti i componenti e i componenti abilitati mediante tabulazione di un contenitore. Un applicazione può contenere numerosi cicli di tabulazioni.
Un'istanza di FocusManager è responsabile di un solo ciclo di tabulazioni; un'applicazione impiega un'istanza di FocusManager differente per gestire ogni singolo ciclo di tabulazioni che contiene, anche se un'applicazione principale è generalmente associata ad almeno un'istanza di FocusManager. Un'applicazione può richiedere istanze aggiuntive di FocusManager se include una finestra a comparsa che, ad esempio, contiene a sua volta uno o più cicli di tabulazioni di componenti.
Tutti i componenti che possono essere gestiti da un'istanza FocusManager devono implementare l'interfaccia fl.managers.IFocusManagerComponent. Gli oggetti la cui attivazione è gestita da Flash Player non sono tenuti a implementare l'interfaccia IFocusManagerComponent.
Anche la classe FocusManager si occupa della gestione dell'implementazione del pulsante predefinito. Un pulsante predefinito invia un evento click ogni volta che il tasto Invio viene premuto su un form, a seconda di dove si trova in quel momento l'attivazione. L'evento click non viene inviato se viene attivata un'area di testo o se viene modificato un valore all'interno di un componente, ad esempio, in ComboBox o NumericStepper.
Vedere anche
| Proprietà | Definito da | ||
|---|---|---|---|
![]() | constructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
| Object | |
| defaultButton: Button
Ottiene o imposta il pulsante predefinito corrente.
| FocusManager | ||
| defaultButtonEnabled: Boolean
Ottiene o imposta un valore che indica se il pulsante predefinito è abilitato.
| FocusManager | ||
| nextTabIndex: int
[sola lettura]
Ottiene il successivo indice di tabulazione univoco da utilizzare in questo ciclo di tabulazioni.
| FocusManager | ||
![]() | prototype: Object
[statico]
Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
| Object | |
| showFocusIndicator: Boolean
Ottiene o imposta un valore che indica se un componente attivo deve essere contrassegnato da un indicatore di attivazione visivo.
| FocusManager | ||
| Metodo | Definito da | ||
|---|---|---|---|
|
FocusManager(container:DisplayObjectContainer)
Crea una nuova istanza FocusManager.
| FocusManager | ||
|
Attiva l'istanza FocusManager.
| FocusManager | ||
|
Disattiva il FocusManager.
| FocusManager | ||
|
Recupera il l'oggetto interattivo che contiene l'oggetto specificato, se presente.
| FocusManager | ||
|
Ottiene l'oggetto interattivo che è l'elemento attivo corrente.
| FocusManager | ||
|
Recupera l'oggetto interattivo che diventerebbe l'elemento attivo se l'utente premesse il tasto Tab per passare all'oggetto successivo.
| FocusManager | ||
![]() |
Indica se per un oggetto è definita una proprietà specifica.
| Object | |
|
Imposta il valore showFocusIndicator su false e rimuove l'indicatore di attivazione visivo dall'oggetto attivo, se presente.
| FocusManager | ||
![]() |
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
| Object | |
![]() |
Indica se la proprietà specificata esiste ed è enumerabile.
| Object | |
|
Imposta come elemento attivo un componente IFocusManagerComponent.
| FocusManager | ||
![]() |
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
| Object | |
|
Imposta il valore showFocusIndicator su true e disegna l'indicatore di attivazione visivo per l'oggetto attivo, se presente.
| FocusManager | ||
![]() |
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
| Object | |
![]() |
Restituisce il valore di base dell'oggetto specificato.
| Object | |
| defaultButton | proprietà |
defaultButton:Button [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Ottiene o imposta il pulsante predefinito corrente.
Il pulsante predefinito è il pulsante di un form che invia un evento click ogni volta che il tasto Invio viene premuto, a seconda di dove si trova in quel momento l'attivazione.
public function get defaultButton():Button
public function set defaultButton(value:Button):void
| defaultButtonEnabled | proprietà |
defaultButtonEnabled:Boolean [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Ottiene o imposta un valore che indica se il pulsante predefinito è abilitato. Se questo valore è impostato su true, il gestore di attivazione esegue il monitoraggio del tasto Invio e invia un evento click al pulsante predefinito quando il tasto Invio viene premuto o quando viene attivato un componente che non è un componente Button. Se questo valore è impostato su false, il gestore di attivazione non esegue il monitoraggio del tasto Invio. Per i componenti che impiegano il tasto Invio, questa proprietà viene impostata su false per impedire che un evento click venga inviato al pulsante predefinito, se esistente, ogni volta che il tasto Invio viene premuto.
public function get defaultButtonEnabled():Boolean
public function set defaultButtonEnabled(value:Boolean):void
| nextTabIndex | proprietà |
nextTabIndex:int [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Ottiene il successivo indice di tabulazione univoco da utilizzare in questo ciclo di tabulazioni.
public function get nextTabIndex():int
| showFocusIndicator | proprietà |
showFocusIndicator:Boolean [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Ottiene o imposta un valore che indica se un componente attivo deve essere contrassegnato da un indicatore di attivazione visivo.
public function get showFocusIndicator():Boolean
public function set showFocusIndicator(value:Boolean):void
| FocusManager | () | Funzione di costruzione |
public function FocusManager(container:DisplayObjectContainer)
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Crea una nuova istanza FocusManager.
Un gestore di attivazione gestisce l'attivazione tra gli elementi secondari di un oggetto DisplayObjectContainer.
Parametricontainer:DisplayObjectContainer — Un DisplayObjectContainer che contiene il gestore di attivazione, oppure stage.
|
| activate | () | metodo |
public function activate():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Attiva l'istanza FocusManager.
L'istanza FocusManager aggiunge i gestori di eventi che consentono di monitorare l'attività della tastiera e del mouse correlata all'attivazione.
| deactivate | () | metodo |
public function deactivate():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Disattiva il FocusManager.
FocusManager rimuove i gestori di eventi che consentono di monitorare l'attività della tastiera e del mouse correlata all'attivazione.
| findFocusManagerComponent | () | metodo |
public function findFocusManagerComponent(component:InteractiveObject):InteractiveObject
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Recupera il l'oggetto interattivo che contiene l'oggetto specificato, se presente. Il player può rendere attivo un sottocomponente di un componente Flash, questo metodo determina quale oggetto interattivo è attivo dal punto di vista del componente.
Parametri
component:InteractiveObject — Un oggetto che può essere l'elemento attivo a livello di Flash Player.
|
InteractiveObject — L'oggetto contenente il componente o, se non viene trovato, ilcomponente stesso.
|
| getFocus | () | metodo |
public function getFocus():InteractiveObject
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Ottiene l'oggetto interattivo che è l'elemento attivo corrente. Adobe consiglia di chiamare questo metodo anziché utilizzare l'oggetto Stage poiché questo metodo indica quale elemento è quello attivo. L'oggetto Stage talvolta può restituire un sottocomponente del componente.
RestituisceInteractiveObject — L'oggetto interattivo che è l'elemento attivo corrente.
|
| getNextFocusManagerComponent | () | metodo |
public function getNextFocusManagerComponent(backward:Boolean = false):InteractiveObject
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Recupera l'oggetto interattivo che diventerebbe l'elemento attivo se l'utente premesse il tasto Tab per passare all'oggetto successivo. Questo metodo recupera l'oggetto che è l'elemento attivo corrente se nell'applicazione non ci sono altri oggetti validi.
Parametri
backward:Boolean (default = false) — Se questo parametro viene impostato su true, l'attivazione si sposta a ritroso, in modo che il metodo recuperi l'oggetto successivo che sarebbe stato attivato premendo la combinazione di tasti Maiusc + Tab.
|
InteractiveObject — Il componente successivo da attivare.
|
| hideFocus | () | metodo |
public function hideFocus():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta il valore showFocusIndicator su false e rimuove l'indicatore di attivazione visivo dall'oggetto attivo, se presente.
| setFocus | () | metodo |
public function setFocus(component:InteractiveObject):void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta come elemento attivo un componente IFocusManagerComponent. Questo metodo non verifica la visibilità, lo stato di attivazione o altre condizioni del componente.
Parametri
component:InteractiveObject — Un oggetto che può ricevere l'attivazione.
|
| showFocus | () | metodo |
public function showFocus():void
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9.0.28.0 |
Imposta il valore showFocusIndicator su true e disegna l'indicatore di attivazione visivo per l'oggetto attivo, se presente.
Per provare l'esempio, eseguire queste operazioni:
package
{
import fl.controls.TextInput;
import fl.managers.FocusManager;
import flash.display.InteractiveObject;
import flash.display.Sprite;
import flash.events.*;
import flash.utils.Timer;
public class FocusManagerExample extends Sprite
{
private var fm:FocusManager;
public function FocusManagerExample() {
buildGridOfTextInputs();
fm = new FocusManager(this);
var t:Timer = new Timer(1000);
t.addEventListener(TimerEvent.TIMER,secondPassed);
t.start();
}
private function buildGridOfTextInputs():void {
var rowSpacing:uint = 30;
var colSpacing:uint = 110;
var totalRows:uint = 4;
var totalCols:uint = 3;
var i:uint;
for(i = 0; i < totalRows * totalCols; i++) {
var ti:TextInput = new TextInput()
ti.name = "component"+i.toString();
ti.addEventListener(FocusEvent.FOCUS_IN,focusChange);
ti.setSize(100,20);
ti.x = 10 + ((i % totalCols) * colSpacing);
ti.y = 10 + (Math.floor(i / totalCols) * rowSpacing);
ti.tabEnabled = true;
addChild(ti);
}
}
private function secondPassed(e:TimerEvent):void {
var nextComponent:InteractiveObject = fm.getNextFocusManagerComponent();
fm.setFocus(nextComponent);
}
private function focusChange(e:FocusEvent):void {
trace("Focus change: " + e.target.name);
}
}
}
Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/managers/FocusManager.html