Paket | fl.managers |
Schnittstelle | public interface IFocusManagerComponent |
Umsetzer | Button, ColorPicker, ComboBox, DataGrid, LabelButton, List, NumericStepper, ScrollPane, SelectableList, Slider, TextArea, TextInput, TileList |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Die UIComponent-Klasse bietet eine Basisimplementierung dieser Schnittstelle, implementiert sie jedoch nicht vollständig, da einige UIComponents-Objekte keinen Fokus erhalten sollen. Komponenten, die von der UIComponent-Klasse abgeleitet werden, müssen diese Schnittstelle implementieren, um den Fokus erhalten zu können. Um den Fokus zu aktivieren, fügen Sie die Anweisung implements IFocusManagerComponent
der Klassendefinition einer Komponente hinzu, die von der UIComponent-Klasse abgeleitet wurde.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
focusEnabled : Boolean
Ruft einen booleschen Wert auf oder stellt einen Wert ein, der angibt, ob eine ausgewählte Komponente den Fokus vom Focus Manager erhalten kann. | IFocusManagerComponent | ||
mouseFocusEnabled : Boolean [schreibgeschützt]
Ruft einen booleschen Wert auf, der angibt, ob eine Komponente, die mit der Maus ausgewählt wurde, den Fokus erhalten kann. | IFocusManagerComponent | ||
tabEnabled : Boolean [schreibgeschützt]
Ruft einen booleschen Wert ab, der angibt, ob der Fokus durch Drücken der Tabulatortaste auf diese Komponente verschoben werden kann. | IFocusManagerComponent | ||
tabIndex : int [schreibgeschützt]
Ruft die Reihenfolge ab, in der die Komponente den Fokus erhält, wenn "tabEnabled" auf „true“ gesetzt wurde. | IFocusManagerComponent |
Methode | Definiert von | ||
---|---|---|---|
Zeichnet einen sichtbaren Fokusindikator. | IFocusManagerComponent | ||
Aktiviert den Fokus für eine Komponente. | IFocusManagerComponent |
focusEnabled | Eigenschaft |
focusEnabled:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft einen booleschen Wert auf oder stellt einen Wert ein, der angibt, ob eine ausgewählte Komponente den Fokus vom Focus Manager erhalten kann.
Wenn eine Komponente den Fokus durch den Focus Manager erhalten können soll, setzen Sie diese Eigenschaft auf true
. Wenn die Komponente keinen Fokus erhalten können soll, setzen Sie diese Eigenschaft auf false
. Wenn focusEnabled
auf false
gesetzt ist, wird die Komponente vom Focus Manager dauerhaft ignoriert und nicht auf Änderungen an den folgenden Eigenschaften überwacht: tabEnabled
, tabChildren
, und mouseFocusEnabled
.
Sie können die Eigenschaft focusEnabled
verwenden, um zu verhindern, dass eine untergeordnete Komponente einer Komponente, die die IFocusManagerComponent-Schnittstelle implementiert, Fokus vom Focus Manager erhält. Setzen Sie hierzu die Eigenschaft auf false
, bevor Sie die addChild()
-Methode verwenden, um die untergeordnete Komponente zur Anzeigeliste hinzuzufügen. Wenn Sie diese Eigenschaft auf false
setzen, bevor die Komponente der Anzeigeliste hinzugefügt wird, wird diese Komponente auch dann weiterhin durch den Focus Manager ignoriert, wenn Sie sie später auf true
setzen.
Hinweis: Auch wenn Sie die Eigenschaft auf false
setzen, können Sie den Fokus trotzdem weiterhin programmgesteuert einrichten. Verwenden Sie hierzu die setFocus()
-Methode.
Implementierung
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
mouseFocusEnabled | Eigenschaft |
mouseFocusEnabled:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft einen booleschen Wert auf, der angibt, ob eine Komponente, die mit der Maus ausgewählt wurde, den Fokus erhalten kann.
Setzen Sie diese Eigenschaft auf true
, um den Fokus Komponenten zuzuweisen, die mit der Maus ausgewählt wurden. Setzen Sie diese Eigenschaft auf false
, wenn Sie verhindern möchten, dass Komponenten, die mit der Maus ausgewählt wurden, Fokus zugewiesen wird. Wenn diese Eigenschaft auf false
gesetzt ist und eine Komponente mit der Maus ausgewählt wird, wird der Fokus auf die erste übergeordnete Komponente übertragen, deren Eigenschaft auf true
gesetzt ist.
Implementierung
public function get mouseFocusEnabled():Boolean
tabEnabled | Eigenschaft |
tabEnabled:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft einen booleschen Wert ab, der angibt, ob der Fokus durch Drücken der Tabulatortaste auf diese Komponente verschoben werden kann. Der Wert true
gibt an, dass der Fokus durch Drücken der Tabulatortaste auf diese Komponente verschoben werden kann, der Wert false
gibt an, dass die Tabulatortaste nicht hierzu verwendet werden kann.
Auch bei der Einstellung false
kann die Komponente den Fokus erhalten, wenn sie mit der Maus oder über einen Aufruf der setFocus()
-Methode ausgewählt wird.
Implementierung
public function get tabEnabled():Boolean
tabIndex | Eigenschaft |
tabIndex:int
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Reihenfolge ab, in der die Komponente den Fokus erhält, wenn tabEnabled
auf true
gesetzt wurde. Die tabIndex
-Eigenschaft hat standardmäßig den Wert -1. Dies bedeutet, dass für das Objekt kein Tabulatorindex festgelegt ist und der Fokus anhand der z-Reihenfolge gesetzt wird.
Die tabIndex
-Eigenschaft kann auch eine positive Ganzzahl sein. In diesem Fall werden die Objekte gemäß ihren tabIndex
-Eigenschaften in aufsteigender Reihenfolge angeordnet. Dabei liegt ein Objekt mit einem tabIndex
-Wert von 1 in der Reihenfolge vor einem Objekt mit einem tabIndex
-Wert von 2. Wenn zwei Objekte den gleichen tabIndex
-Wert aufweisen, gilt das Objekt, das in der standardmäßigen Tabulatorreihenfolge vor dem anderen kommt, als vorrangig.
Der Standardwert ist -1.
Implementierung
public function get tabIndex():int
drawFocus | () | Methode |
public function drawFocus(draw:Boolean):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Zeichnet einen sichtbaren Fokusindikator.
Diese Methode wird vom Focus Manager aufgerufen, wenn die Komponente den Fokus erhält. Die Komponente soll eine Grafik zeichnen bzw. ausblenden, durch die angezeigt wird, dass der Fokus auf der Komponente liegt.
Parameter
draw:Boolean — Wenn true angegeben ist, ist der Fokusindikator sichtbar, andernfalls wird er ausgeblendet.
|
setFocus | () | Methode |
public function setFocus():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Aktiviert den Fokus für eine Komponente.
Diese Methode wird vom Focus Manager aufgerufen, wenn die Komponente den Fokus erhält. Die Komponente kann den Fokus wiederum auf eine interne Komponente übertragen.
Tue Jun 12 2018, 10:04 AM Z