Paket | spark.layouts.supportClasses |
Klasse | public class LayoutBase |
Vererbung | LayoutBase OnDemandEventDispatcher Object |
Unterklassen | BasicLayout, ButtonBarHorizontalLayout, ConstraintLayout, HorizontalLayout, MosaicLayoutBase, TabbedViewNavigatorTabBarHorizontalLayout, TileLayout, VerticalLayout, ViewMenuLayout |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
LayoutBase
oder eine der zugehörigen Unterklassen erweitern.
Die Unterklassen müssen mindestens die updateDisplayList()
-Methode, die die Elemente der target
-GroupBase platziert und deren Größe ändert, und die measure()
-Methode implementieren, die die Standardgröße des target
berechnet.
Unterklassen können Methoden wie getElementBoundsAboveScrollRect()
und getElementBoundsBelowScrollRect()
überschreiben, um das Verhalten des Ziels anzupassen, wenn es mit Bildlaufleisten verbunden ist.
Unterklassen, die die Virtualisierung unterstützen, müssen die useVirtualLayout
-Eigenschaft respektieren und sollten nur Layoutelemente im scrollRect (der Wert von getScrollRect()
) mithilfe von getVirtualElementAt()
aus der updateDisplayList()
-Methode abrufen.
The <s:LayoutBase>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:LayoutBase Properties clipAndEnableScrolling="false" dropIndicator="defined by the skin class" horizontalScrollPosition="0" target="null" typicalLayoutElement="null" useVirtualLayout="false" verticalScrollPosition="0" />
Eigenschaft | Definiert von | ||
---|---|---|---|
clipAndEnableScrolling : Boolean
Mit „true“ wird angegeben, dass die untergeordneten Elemente auf die Begrenzungen des Viewports gekürzt werden. | LayoutBase | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
dropIndicator : DisplayObject
Das von diesem Layout für den Dropindikator bei Drag & Drop-Vorgängen verwendete DisplayObject. | LayoutBase | ||
horizontalScrollPosition : Number
Die x-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente. | LayoutBase | ||
target : GroupBase
Der GroupBase-Container, dessen Elemente von diesem Layout gemessen und platziert werden und deren Größe geändert wird. | LayoutBase | ||
typicalLayoutElement : ILayoutElement
In Layouts verwendet, wenn feste Zeilen- bzw. Spaltengrößen angefordert sind, jedoch keine bestimmte Größe angegeben ist. | LayoutBase | ||
useVirtualLayout : Boolean
Ein Container kann eine beliebige Anzahl an untergeordneten Objekten definieren. | LayoutBase | ||
verticalScrollPosition : Number
Die y-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente. | LayoutBase |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | LayoutBase | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | OnDemandEventDispatcher | ||
Berechnet die Ablageposition im Datenprovider des Ablageziels für den angegebenen dragEvent. | LayoutBase | ||
Ist useVirtualLayout „true“, kann diese Methode vom Layoutziel verwendet werden, um zwischengespeicherte Layoutinformationen zu löschen, wenn sich das Ziel ändert. | LayoutBase | ||
Sendet ein Ereignis in den Ereignisablauf. | OnDemandEventDispatcher | ||
Wird vom Ziel aufgerufen, nachdem ein Layoutelement hinzugefügt wurde und bevor die Größe und Anzeigeliste des Ziels überprüft wurden. | LayoutBase | ||
Diese Methode muss vom Ziel aufgerufen werden, nachdem ein Layoutelement entfernt wurde und bevor die Größe und Anzeigeliste des Ziels validiert werden. | LayoutBase | ||
Gibt die Layoutgrenzen des angegebenen Elements als Rechteck zurück oder null, wenn die Indexposition ungültig, das entsprechende Element null, includeInLayout=false oder die Zieleigenschaft des Layouts null ist. | LayoutBase | ||
Gibt die Änderung der horizontalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten. | LayoutBase | ||
getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Delegationsmethode, die auf Grundlage des aktuellen Elements im Fokus und der Benutzereingabe hinsichtlich der NavigationUnit bestimmt, zu welchem Element zu navigieren ist. | LayoutBase | ||
Berechnet das verticalScrollPosition- und das horizontalScrollPosition-Delta, die benötigt werden, um einen Bildlauf des Elements an der angegebenen Indexposition in die Ansicht durchzuführen. | LayoutBase | ||
Gibt die Änderung der vertikalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten. | LayoutBase | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | OnDemandEventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Blendet den zuvor angezeigten Dropindikator, der durch die showDropIndicator()-Methode erstellt wurde, aus und entfernt ihn aus der Anzeigeliste. Beendet außerdem den Ziehbildlauf. | LayoutBase | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Misst die Standardgröße des Ziels auf Grundlage des Inhalts und misst optional die standardmäßige minimale Größe des Ziels. | LayoutBase | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | OnDemandEventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Platziert den Dropindikator und verändert dessen Größe anhand der angegebenen Ablageposition und ist sein übergeordnetes Element. | LayoutBase | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Platziert die Elemente des Ziels und ändert deren Größe. | LayoutBase | ||
Wird vom Ziel am Ende der updateDisplayList()-Methode aufgerufen, damit das Layout das scrollRect aktualisiert. | LayoutBase | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | OnDemandEventDispatcher |
Methode | Definiert von | ||
---|---|---|---|
Berechnet die Länge des erforderlichen Bildlaufs für die angegebene dropLocation während eines Drag & Drop-Vorgangs. | LayoutBase | ||
Gibt die Indexposition zurück, an der ein neues Objekt einzufügen ist, wenn der Benutzer die Maus an den angegebenen Koordinaten loslässt, während er einen Drag & Drop-Vorgang ausführt. | LayoutBase | ||
Berechnet die Grenzen des Dropindikators, der dem Benutzer anzeigt, wo die Objekte am Ende eines Drag & Drop-Vorgangs eingefügt werden. | LayoutBase | ||
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet. | LayoutBase | ||
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet. | LayoutBase | ||
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet. | LayoutBase | ||
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet. | LayoutBase | ||
Gibt die Grenzen des Bildlaufrechtecks des Ziels in Layoutkoordinaten zurück. | LayoutBase | ||
Wird aufgerufen, wenn sich die verticalScrollPosition- oder horizontalScrollPosition-Eigenschaft ändert. | LayoutBase |
clipAndEnableScrolling | Eigenschaft |
clipAndEnableScrolling:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Mit true
wird angegeben, dass die untergeordneten Elemente auf die Begrenzungen des Viewports gekürzt werden. Mit false
wird angegeben, dass die untergeordneten Elemente des Containers über die Begrenzungen des Containers hinausragen, und zwar unabhängig von den Größenspezifikationen der Komponente.
Der Standardwert ist false.
Implementierung
public function get clipAndEnableScrolling():Boolean
public function set clipAndEnableScrolling(value:Boolean):void
dropIndicator | Eigenschaft |
dropIndicator:DisplayObject
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das von diesem Layout für den Dropindikator bei Drag & Drop-Vorgängen verwendete DisplayObject
. Normalerweise legen Sie diese Eigenschaft nicht direkt fest, sondern definieren stattdessen einen dropIndicator
-Skinteil in der Skinklasse des Ablageziels.
Das List-Steuerelement legt diese Eigenschaft als Reaktion auf ein DragEvent.DRAG_ENTER
-Ereignis fest. Die List initialisiert diese Eigenschaft mit einer Instanz ihres dropIndicator
-Skinteils. Die List löscht diese Eigenschaft als Reaktion auf ein DragEvent.DRAG_EXIT
-Ereignis.
Implementierung
public function get dropIndicator():DisplayObject
public function set dropIndicator(value:DisplayObject):void
horizontalScrollPosition | Eigenschaft |
horizontalScrollPosition:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die x-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente. Wenn clipAndEnableScrolling
auf true
eingestellt ist, führt das Einstellen dieser Eigenschaft normalerweise dazu, dass für den Viewport Folgendes festgelegt wird:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)Implementierungen dieser Eigenschaft müssen bindbar sein und müssen Ereignisse des Typs
propertyChange
generieren.
Der Standardwert ist 0.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange
-Ereignis ausgelöst.
Implementierung
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
target | Eigenschaft |
target:GroupBase
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der GroupBase-Container, dessen Elemente von diesem Layout gemessen und platziert werden und deren Größe geändert wird.
Unterklassen können diesen Set-Zugriff überschreiben, um zielspezifische Aktionen auszuführen. So kann beispielsweise ein 3D-Layout die maintainProjectionCenter
-Eigenschaft des Ziels hier einstellen.
Der Standardwert ist null.
Implementierung
public function get target():GroupBase
public function set target(value:GroupBase):void
Verwandte API-Elemente
typicalLayoutElement | Eigenschaft |
typicalLayoutElement:ILayoutElement
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
In Layouts verwendet, wenn feste Zeilen- bzw. Spaltengrößen angefordert sind, jedoch keine bestimmte Größe angegeben ist. Wird von virtuellen Layouts verwendet, um die Größe von Layoutelementen zu schätzen, für die kein Bildlauf in die Ansicht durchgeführt wurde.
Diese Eigenschaft referenziert eine von Flex zur Definition der Höhe aller untergeordneten Container verwendete Komponente, siehe folgendes Beispiel:
<s:Group> <s:layout> <s:VerticalLayout variableRowHeight="false" typicalLayoutElement="{b3}"/> </s:layout> <s:Button id="b1" label="Button 1"/> <s:Button id="b2" label="Button 2"/> <s:Button id="b3" label="Button 3" fontSize="36"/> <s:Button id="b4" label="Button 4" fontSize="24"/> </s:Group>
Wenn diese Eigenschaft nicht eingestellt wurde und das Ziel ungleich null ist, wird das erste Layoutelement des Ziels zwischengespeichert und zurückgegeben.
Der Standardwert ist das erste Layoutelement des Ziels.
Der Standardwert ist null.
Implementierung
public function get typicalLayoutElement():ILayoutElement
public function set typicalLayoutElement(value:ILayoutElement):void
Verwandte API-Elemente
useVirtualLayout | Eigenschaft |
useVirtualLayout:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Container kann eine beliebige Anzahl an untergeordneten Objekten definieren. Für jedes untergeordnete Objekt ist jedoch eine Instanz eines Elementrenderers erforderlich. Hat der Container viele untergeordnete Objekte, können beim Hinzufügen weiterer untergeordneter Objekte zum Container Leistungseinbußen auftreten.
Statt für jedes untergeordnete Objekt einen Elementrenderer zu erstellen, können Sie den Container so konfigurieren, dass er ein virtuelles Layout verwendet. Bei einem virtuellen Layout werden Elementrenderer vom Container wiederverwendet, d. h. dass der Container nur für seine aktuell sichtbaren untergeordneten Objekte Elementrenderer erstellt. Wenn ein untergeordnetes Objekt aus dem Bildschirm verschwindet, z. B. durch einen Bildlauf des Containers, kann ein neu in den Bildschirm gescrolltes untergeordnetes Objekt seinen Elementrenderer wiederverwenden.
Um einen Container auf virtuelles Layout zu konfigurieren, legen Sie für die useVirtualLayout
-Eigenschaft den Wert true
für das mit dem Container verknüpfte Layout fest. Nur DataGroup oder SkinnableDataContainer mit Layout auf VerticalLayout, HorizontalLayout oder TileLayout gesetzt, unterstützt virtuelles Layout. Layoutunterklassen, die keine Virtualisierung unterstützen, müssen ein Ändern dieser Eigenschaft verhindern.
Hinweis: Die BasicLayout-Klasse gibt einen Laufzeitfehler aus, wenn Sie useVirtualLayout
auf true
setzen.
Bei true
müssen Layouts, die Virtualisierung unterstützen, die target.getVirtualElementAt()
- anstatt der getElementAt()
-Methode verwenden und dürfen nur Elemente abrufen, deren Sichtbarkeit erwartet wird, wenn der Wert von getScrollRect()
verwendet wird.
Bei true
muss die Layoutklasse die Indexpositionen der Layoutelemente, die das scrollRect
überlappen, in der zugehörigen updateDisplayList()
-Methode berechnen. Dabei werden ausschließlich zwischengespeicherte Informationen verwendet und nicht Layoutelemente abgerufen und deren Grenzen geprüft.
Normalerweise aktualisieren virtuelle Layouts die zugehörigen zwischengespeicherten Informationen in der updateDisplayList()
-Methode. Dabei werden die Größen und Positionen verwendet, die für die Elemente in der Ansicht berechnet wurden.
Entsprechend sollten zur measure()
-Zeit die virtuellen Layouts die Eigenschaften für die gemessene Größe des Ziels aktualisieren, indem sie das typicalLayoutElement
und sonstige zwischengespeicherte Layoutinformationen, nicht jedoch Messungen der Elemente heranziehen.
Container kooperieren mit Layouts, deren Wert für useVirtualLayout
= true
ist, indem sie Elementrenderer wiederverwenden, die früher erstellt, jedoch nicht mehr benutzt wurden. Ein Objekt wird als nicht mehr verwendet betrachtet, wenn die zugehörige Indexposition nicht im Bereich der getVirtualElementAt()
-Indexpositionen liegt, die während des letzten updateDisplayList()
-Aufrufs des Containers angefordert wurden.
Der Standardwert ist false.
Implementierung
public function get useVirtualLayout():Boolean
public function set useVirtualLayout(value:Boolean):void
Verwandte API-Elemente
verticalScrollPosition | Eigenschaft |
verticalScrollPosition:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die y-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente. Wenn clipAndEnableScrolling
auf true
eingestellt ist, führt das Einstellen dieser Eigenschaft normalerweise dazu, dass für den Viewport Folgendes festgelegt wird:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)Implementierungen dieser Eigenschaft müssen bindbar sein und müssen Ereignisse des Typs
propertyChange
generieren.
Der Standardwert ist 0.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange
-Ereignis ausgelöst.
Implementierung
public function get verticalScrollPosition():Number
public function set verticalScrollPosition(value:Number):void
LayoutBase | () | Konstruktor |
public function LayoutBase()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
calculateDragScrollDelta | () | Methode |
protected function calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Berechnet die Länge des erforderlichen Bildlaufs für die angegebene dropLocation
während eines Drag & Drop-Vorgangs. Von der showDropIndicator()
-Methode aufgerufen, um den Bildlauf während des Ziehbildlaufs zu berechnen.
Parameter
dropLocation:DropLocation — Ein gültiges DropLocation-Objekt, das bereits vorher durch Aufrufen der calculateDropLocation() -Methode erhalten wurde.
| |
elapsedTime:Number — Die Dauer (in Millisekunden) ab Beginn des Ziehbildlaufvorgangs.
|
Point — Wie weit beim Bildlaufvorgang gezogen werden muss oder null, wenn kein Ziehbildlauf erforderlich ist.
|
Verwandte API-Elemente
calculateDropIndex | () | Methode |
protected function calculateDropIndex(x:Number, y:Number):int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Indexposition zurück, an der ein neues Objekt einzufügen ist, wenn der Benutzer die Maus an den angegebenen Koordinaten loslässt, während er einen Drag & Drop-Vorgang ausführt. Von der calculatedDropLocation()
-Methode aufgerufen.
Parameter
x:Number — Die x-Koordinate des Drag & Drop-Vorgangs, in lokalen Koordinaten.
| |
y:Number — Die y-Koordinate des Drag & Drop-Vorgangs, in den lokalen Koordinaten des Ablageziels.
|
int — Die Ablageindexposition oder -1, wenn der Ablagevorgang an den angegebenen Koordinaten nicht verfügbar ist.
|
Verwandte API-Elemente
calculateDropIndicatorBounds | () | Methode |
protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Berechnet die Grenzen des Dropindikators, der dem Benutzer anzeigt, wo die Objekte am Ende eines Drag & Drop-Vorgangs eingefügt werden. Von der showDropIndicator()
-Methode aufgerufen.
Parameter
dropLocation:DropLocation — Ein gültiges DropLocation-Objekt, das bereits vorher von der calculateDropLocation() -Methode zurückgegeben wurde.
|
Rectangle — Die Grenzen für den Dropindikator oder null.
|
Verwandte API-Elemente
calculateDropLocation | () | Methode |
public function calculateDropLocation(dragEvent:DragEvent):DropLocation
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Berechnet die Ablageposition im Datenprovider des Ablageziels für den angegebenen dragEvent
.
Parameter
dragEvent:DragEvent — Das vom DragManager ausgelöste Ziehereignis.
|
DropLocation — Gibt die Ablageposition für dieses Ereignis zurück oder null, wenn der Ablagevorgang nicht verfügbar ist.
|
Verwandte API-Elemente
clearVirtualLayoutCache | () | Methode |
public function clearVirtualLayoutCache():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ist useVirtualLayout
true
, kann diese Methode vom Layoutziel verwendet werden, um zwischengespeicherte Layoutinformationen zu löschen, wenn sich das Ziel ändert.
Wenn sich beispielsweise die dataProvider
- oder itemRenderer
-Eigenschaft einer DataGroup ändert, wird die Größe der zwischengespeicherten Elemente ungültig.
Wenn sich die useVirtualLayout
-Eigenschaft in false
ändert, wird diese Methode automatisch aufgerufen.
Unterklassen, die useVirtualLayout
= true
unterstützen, müssen diese Methode überschreiben.
elementAdded | () | Methode |
public function elementAdded(index:int):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird vom Ziel aufgerufen, nachdem ein Layoutelement hinzugefügt wurde und bevor die Größe und Anzeigeliste des Ziels überprüft wurden. Layouts (z. B. virtuelle Layouts), die nach Elementstatus zwischenspeichern, können diese Methode überschreiben, um ihren Cache zu aktualisieren.
Wenn das Ziel diese Methode aufruft, garantiert es nur, dass zur updateDisplayList()
-Zeit an der angegebenen Indexposition ein Layoutelement verfügbar ist. So wird diese Methode beispielsweise von einer DataGroup mit einem virtuellen Layout aufgerufen, wenn dem dataProvider
des Ziels ein Objekt hinzugefügt wird.
Der Aufruf dieser Methode hat standardmäßig keine Auswirkungen.
Parameter
index:int — Die Indexposition des Elements, das hinzugefügt wurde.
|
Verwandte API-Elemente
elementRemoved | () | Methode |
public function elementRemoved(index:int):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Diese Methode muss vom Ziel aufgerufen werden, nachdem ein Layoutelement entfernt wurde und bevor die Größe und Anzeigeliste des Ziels validiert werden. Layouts (z. B. virtuelle Layouts), die nach Elementstatus zwischenspeichern, können diese Methode überschreiben, um ihren Cache zu aktualisieren.
Wenn das Ziel diese Methode aufruft, garantiert es nur, dass zur updateDisplayList()
-Zeit an der angegebenen Indexposition kein Layoutelement mehr verfügbar ist. Beispiel: Eine DataGroup mit einem virtuellen Layout ruft diese Methode auf, wenn der dataProvider
-Eigenschaft ein Objekt hinzugefügt wird.
Der Aufruf dieser Methode hat standardmäßig keine Auswirkungen.
Parameter
index:int — Die Indexposition des Elements, das hinzugefügt wurde.
|
Verwandte API-Elemente
getElementBounds | () | Methode |
public function getElementBounds(index:int):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Layoutgrenzen des angegebenen Elements als Rechteck zurück oder null, wenn die Indexposition ungültig, das entsprechende Element null, includeInLayout=false
oder die target
-Eigenschaft des Layouts null ist.
Layoutunterklassen, die useVirtualLayout=true
unterstützen, müssen diese Methode überschreiben, um einen möglichen Näherungswert für Elemente zu berechnen, die sich nicht in der Ansicht befinden.
Parameter
index:int — Indexposition des Layoutelements.
|
Rectangle — Die Layoutgrenzen des angegebenen Elements.
|
Verwandte API-Elemente
getElementBoundsAboveScrollRect | () | Methode |
protected function getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet.
Dies ist eine Bedarfsmethode, die von der Standardimplementierung der getVerticalScrollPositionDelta()
-Methode verwendet wird. Unterklassen, die die Standardimplementierung von getVerticalScrollPositionDelta()
verwenden, sollten diese Methode überschreiben, um ein genaues Begrenzungsrechteck mit gültigen top
- und bottom
-Eigenschaften anzugeben.
Standardmäßig gibt diese Methode ein Rechteck mit „width“ = 0 und „height“ = 1, wobei die Oberkante um eins weniger als die Oberkante von scrollRect
ist, und „left“ = 0 zurück.
Unterklassen sollten diese Methode überschreiben, um ein genaues Begrenzungsrechteck mit gültigen top
- und bottom
-Eigenschaften anzugeben.
Parameter
scrollRect:Rectangle — Das scrollRect des Ziels.
|
Rectangle — Die Grenzen des ersten Elements, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet.
|
Verwandte API-Elemente
getElementBoundsBelowScrollRect | () | Methode |
protected function getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet.
Dies ist eine Bedarfsmethode, die von der Standardimplementierung der getVerticalScrollPositionDelta()
-Methode verwendet wird. Unterklassen, die die Standardimplementierung von getVerticalScrollPositionDelta()
verwenden, sollten diese Methode überschreiben, um ein genaues Begrenzungsrechteck mit gültigen top
- und bottom
-Eigenschaften anzugeben.
Standardmäßig gibt diese Methode ein Rechteck mit „width“ = 0 und „height“ = 1 zurück, wobei die Unterkante um eins höher als die Unterkante von scrollRect
ist, und „left“ = 0.
Parameter
scrollRect:Rectangle — Das scrollRect des Ziels.
|
Rectangle — Die Grenzen des ersten Elements, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet.
|
Verwandte API-Elemente
getElementBoundsLeftOfScrollRect | () | Methode |
protected function getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet.
Dies ist eine Bedarfsmethode, die von der Standardimplementierung der getHorizontalScrollPositionDelta()
-Methode verwendet wird. Unterklassen, die die Standardimplementierung von getHorizontalScrollPositionDelta()
verwenden, sollten diese Methode überschreiben, um ein genaues Begrenzungsrechteck mit gültigen left
- und right
-Eigenschaften anzugeben.
Standardmäßig gibt diese Methode ein Rechteck mit „width“ = 1 und „height“ = 0 zurück, wobei die linke Kante um eins weniger als die linke Kante von scrollRect
ist, und „top“ = 0.
Parameter
scrollRect:Rectangle — Das scrollRect des Ziels.
|
Rectangle — Die Grenzen des ersten Elements, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet.
|
Verwandte API-Elemente
getElementBoundsRightOfScrollRect | () | Methode |
protected function getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet.
Dies ist eine Bedarfsmethode, die von der Standardimplementierung der getHorizontalScrollPositionDelta()
-Methode verwendet wird. Unterklassen, die die Standardimplementierung von getHorizontalScrollPositionDelta()
verwenden, sollten diese Methode überschreiben, um ein genaues Begrenzungsrechteck mit gültigen left
- und right
-Eigenschaften anzugeben.
Standardmäßig gibt diese Methode ein Rechteck mit „width“ = 1 und „height“ = 0 zurück, wobei die rechte Kante um eins weniger als die rechte Kante von scrollRect
ist, und „top“ = 0.
Parameter
scrollRect:Rectangle — Das scrollRect des Ziels.
|
Rectangle — Die Grenzen des ersten Elements, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet.
|
Verwandte API-Elemente
getHorizontalScrollPositionDelta | () | Methode |
public function getHorizontalScrollPositionDelta(navigationUnit:uint):Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Änderung der horizontalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten. Diese Optionen sind durch die NavigationUnit-Klasse definiert: END
, HOME
, LEFT
, PAGE_LEFT
, PAGE_RIGHT
und RIGHT
.
Parameter
navigationUnit:uint — Nimmt folgende Werte an:
Die Implementierung ruft |
Number — Die Änderung an der horizontalen Bildlaufposition.
|
Verwandte API-Elemente
getNavigationDestinationIndex | () | Methode |
public function getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Delegationsmethode, die auf Grundlage des aktuellen Elements im Fokus und der Benutzereingabe hinsichtlich der NavigationUnit bestimmt, zu welchem Element zu navigieren ist. Diese Methode wird von Unterklassen von ListBase verwendet, um die Tastaturnavigation zu verarbeiten. ListBase ordnet Benutzereingaben zu NavigationUnit-Konstanten zu.
Unterklassen können diese Methode überschreiben, um andere Werte zu berechnen, die auf der aktuellen Indexposition und dem festgestellten Tastenanschlag basieren.
Parameter
currentIndex:int — Die aktuelle Indexposition des Elements im Fokus.
| |
navigationUnit:uint — Die NavigationUnit-Konstante, die bestimmt, zu welchem Element als nächstes navigiert wird.
| |
arrowKeysWrapFocus:Boolean — Beim Wert true ist durch die Pfeiltasten ein Navigieren innerhalb der Komponentenumbrüche möglich, wenn eines der Enden erreicht ist.
|
int — Die Indexposition des nächsten Elements, zu dem gesprungen wird. Gibt „-1“ zurück, wenn das Layout die navigationUnit nicht erkennt.
|
getScrollPositionDeltaToElement | () | Methode |
public function getScrollPositionDeltaToElement(index:int):Point
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Berechnet das verticalScrollPosition
- und das horizontalScrollPosition
-Delta, die benötigt werden, um einen Bildlauf des Elements an der angegebenen Indexposition in die Ansicht durchzuführen.
Diese Methode versucht, die Änderung in verticalScrollPosition
und horizontalScrollPosition
zu minimieren.
Wenn clipAndEnableScrolling
auf true
eingestellt und das Element an der angegebenen Indexposition relativ zum scrollRect des Ziels nicht vollkommen sichtbar ist, wird das Delta zurückgegeben, das zu horizontalScrollPosition
und verticalScrollPosition
hinzuzufügen ist, wodurch ein Bildlauf durchgeführt wird, durch den das Element vollständig in den Grenzen des scrollRect sichtbar ist.
Parameter
index:int — Die Indexposition des Elements, für das ein Bildlauf in die Ansicht durchgeführt werden soll.
|
Point — Ein Punkt, der Offsets zu horizontalScrollPosition und verticalScrollPosition enthält, durch die ein Bildlauf des angegebenen Elements in die Ansicht durchgeführt wird, oder null, wenn keine Änderung erforderlich ist. Ist das angegebene Element nur zum Teil sichtbar und größer als das Bildlaufrechteck, d. h. es ist bereits das einzig sichtbare Element, wird null zurückgegeben. Wenn die angegebene Indexposition ungültig oder das Ziel null ist, wird null zurückgegeben. Wenn das Element an der angegebenen Indexposition null oder includeInLayout auf „false“ eingestellt ist, wird null zurückgegeben.
|
Verwandte API-Elemente
getScrollRect | () | Methode |
protected function getScrollRect():Rectangle
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Grenzen des Bildlaufrechtecks des Ziels in Layoutkoordinaten zurück. Layoutmethoden sollten das Bildlaufrechteck des Ziels nicht direkt abrufen.
RückgabewerteRectangle — Die Grenzen des scrollRect des Ziels in Layoutkoordinaten, null, wenn das Ziel oder clipAndEnableScrolling auf „false“ eingestellt ist.
|
getVerticalScrollPositionDelta | () | Methode |
public function getVerticalScrollPositionDelta(navigationUnit:uint):Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Änderung der vertikalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten. Diese Optionen sind durch die NavigationUnit-Klasse definiert: DOWN
, END
, HOME
, PAGE_DOWN
, PAGE_UP
und UP
.
Parameter
navigationUnit:uint — Nimmt folgende Werte an:
PAGE_UP Die Implementierung ruft |
Number — Die Änderung an der vertikalen Bildlaufposition.
|
Verwandte API-Elemente
hideDropIndicator | () | Methode |
public function hideDropIndicator():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Blendet den zuvor angezeigten Dropindikator, der durch die showDropIndicator()
-Methode erstellt wurde, aus und entfernt ihn aus der Anzeigeliste. Beendet außerdem den Ziehbildlauf.
Verwandte API-Elemente
measure | () | Methode |
public function measure():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Misst die Standardgröße des Ziels auf Grundlage des Inhalts und misst optional die standardmäßige minimale Größe des Ziels.
Dies ist eine der Methoden, die Sie beim Erstellen einer Unterklasse von LayoutBase überschreiben müssen. Die andere Methode lautet updateDisplayList()
. Sie rufen diese Methoden nicht direkt auf. Flex ruft diese Methode im Zuge einer Layoutübergabe auf. Eine Layoutübergabe umfasst drei Phasen.
Wenn die Eigenschaften des Ziels ungültig sind, ruft LayoutManager zunächst die commitProperties
-Methode des Ziels auf.
Wenn die Größe des Ziels ungültig ist, ruft LayoutManager danach die validateSize()
-Methode des Ziels auf. Daraufhin ruft die validateSize()
-Methode des Ziels wiederum die measure()
-Methode des Layouts auf, um die Standardgröße des Ziels zu berechnen, wenn diese nicht explizit durch die Eigenschaften explicitWidth
und explicitHeight
des Ziels angegeben ist. Wenn sich die Standardgröße ändert, macht Flex die Anzeigeliste des Ziels ungültig.
Wenn die Anzeigeliste des Ziels ungültig ist, ruft LayoutManager schließlich die validateDisplayList
-Methode des Ziels auf. Die validateDisplayList
-Methode des Ziels ruft wiederum die updateDisplayList
-Methode des Ziels auf, um die Elemente des Ziels zu platzieren und deren Größe zu ändern.
Beim Implementieren dieser Methode müssen Sie die Eigenschaften measuredWidth
und measuredHeight
des Ziels festlegen, um die Standardgröße des Ziels zu definieren. Optional können Sie die Eigenschaften measuredMinWidth
und measuredMinHeight
festlegen, um die Standardmindestgröße zu definieren. Eine typische Implementierung durchläuft die Elemente des Ziels und verwendet die von ILayoutElement
definierten Methoden, um die bevorzugten und/oder minimalen Größen der Elemente zusammenzutragen, und legt anschließend die Eigenschaften measuredWidth
, measuredHeight
, measuredMinWidth
und measuredMinHeight
fest.
Verwandte API-Elemente
scrollPositionChanged | () | Methode |
protected function scrollPositionChanged():void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird aufgerufen, wenn sich die verticalScrollPosition
- oder horizontalScrollPosition
-Eigenschaft ändert.
Die Standardimplementierung aktualisiert die scrollRect
-Eigenschaft des Ziels durch Aufrufen der updateScrollRect()
-Methode. Unterklassen können diese Methode überschreiben, um andere Werte zu berechnen, die auf der aktuellen scrollPosition
oder dem aktuellen scrollRect
basieren.
Verwandte API-Elemente
showDropIndicator | () | Methode |
public function showDropIndicator(dropLocation:DropLocation):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Platziert den Dropindikator und verändert dessen Größe anhand der angegebenen Ablageposition und ist sein übergeordnetes Element. Verwenden Sie die calculateDropLocation()
-Methode, um das DropLocation-Objekt zu erhalten.
Startet und beendet Ziehbildlaufvorgänge, wenn die erforderlichen Bedingungen erfüllt sind.
Parameter
dropLocation:DropLocation — Legt die Position fest, an der der Dropindikator einzublenden ist. Die Ablageposition wird über die computeDropLocation() -Methode bezogen.
|
Verwandte API-Elemente
updateDisplayList | () | Methode |
public function updateDisplayList(width:Number, height:Number):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Platziert die Elemente des Ziels und ändert deren Größe.
Dies ist eine der Methoden, die Sie beim Erstellen einer Unterklasse von LayoutBase überschreiben müssen. Die andere Methode lautet measure()
. Sie rufen diese Methoden nicht direkt auf. Flex ruft diese Methode im Zuge einer Layoutübergabe auf. Eine Layoutübergabe umfasst drei Phasen.
Wenn die Eigenschaften des Ziels ungültig sind, ruft LayoutManager zunächst die commitProperties
-Methode des Ziels auf.
Wenn die Größe des Ziels ungültig ist, ruft LayoutManager danach die validateSize()
-Methode des Ziels auf. Daraufhin ruft die validateSize()
-Methode des Ziels wiederum die measure()
-Methode des Layouts auf, um die Standardgröße des Ziels zu berechnen, wenn diese nicht explizit durch die Eigenschaften explicitWidth
und explicitHeight
des Ziels angegeben ist. Wenn sich die Standardgröße ändert, macht Flex die Anzeigeliste des Ziels ungültig.
Wenn die Anzeigeliste des Ziels ungültig ist, ruft LayoutManager schließlich die validateDisplayList
-Methode des Ziels auf. Die validateDisplayList
-Methode des Ziels ruft wiederum die updateDisplayList
-Methode des Ziels auf, um die Elemente des Ziels zu platzieren und deren Größe zu ändern.
Eine typische Implementierung durchläuft die Elemente des Ziels und verwendet die Methoden, die von ILayoutElement
definiert sind, um die Elemente zu platzieren und deren Größe zu ändern. Anschließend muss das Layout auch die Eigenschaften contentWidth
und contentHeight
des Ziels berechnen und festlegen, um den Bildlaufbereich des Ziels zu definieren.
Parameter
width:Number — Gibt die Breite des Ziels in Pixeln in den Koordinaten des Ziels an.
| |
height:Number — Gibt die Höhe der Komponente in Pixeln in den Koordinaten des Ziels an.
|
Verwandte API-Elemente
updateScrollRect | () | Methode |
public function updateScrollRect(w:Number, h:Number):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird vom Ziel am Ende der updateDisplayList()
-Methode aufgerufen, damit das Layout das scrollRect aktualisiert.
Wenn clipAndEnableScrolling
den Wert true
hat, stellt die Standardimplementierung den Ursprung des scrollRect
des Ziels auf verticalScrollPosition
, horizontalScrollPosition
ein. Es legt seine Größe auf die width
- und height
-Parameter (nicht skalierte Breite und Höhe des Ziels) fest.
Wenn clipAndEnableScrolling
den Wert false
hat, legt die Standardimplementierung für das scrollRect
den Wert null fest.
Parameter
w:Number — Die Breite des Ziels.
| |
h:Number — Die Höhe des Ziels.
|
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z