Pacchettofl.managers
Classepublic class FocusManager
EreditarietàFocusManager Inheritance Object
Implementa IFocusManager

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

La classe FocusManager gestisce l'attivazione per una serie di componenti navigabili mediante mouse o tastiera in una sequenza ciclica di tabulazioni.

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 gli esempi

Vedere anche

IFocusManager
IFocusManagerComponent


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: 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
 Inheritedprototype: 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
Metodi pubblici
 MetodoDefinito da
  
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
 Inherited
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
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
Imposta come elemento attivo un componente IFocusManagerComponent.
FocusManager
 Inherited
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
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
defaultButtonproprietà
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.


Implementazione
    public function get defaultButton():Button
    public function set defaultButton(value:Button):void
defaultButtonEnabledproprietà 
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.


Implementazione
    public function get defaultButtonEnabled():Boolean
    public function set defaultButtonEnabled(value:Boolean):void
nextTabIndexproprietà 
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.


Implementazione
    public function get nextTabIndex():int
showFocusIndicatorproprietà 
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.


Implementazione
    public function get showFocusIndicator():Boolean
    public function set showFocusIndicator(value:Boolean):void
Descrizione della funzione di costruzione
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.

Parametri
container:DisplayObjectContainer — Un DisplayObjectContainer che contiene il gestore di attivazione, oppure stage.
Descrizione dei metodi
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.

Restituisce
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.

Restituisce
InteractiveObject — 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.

Restituisce
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.

Esempi Come utilizzare gli esempi
FocusManagerExample.as

Questo esempio mostra come utilizzare la classe FocusManager per modificare l'attivazione dei componenti sullo stage.

Per provare l'esempio, eseguire queste operazioni:

  1. Aggiungere il componente TextInput alla libreria.
  2. Salvare il codice come FocusManagerExample.as nella stessa directory del file FLA.
  3. Impostare la classe documento nel file FLA su FocusManagerExample.
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