LayoutBase  - AS3 Flex

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.

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.

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)
      

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.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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)
      

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.

Konstruktor.

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

Berechnet die Ablageposition im Datenprovider des Ablageziels für den angegebenen dragEvent.

Parameter

Verwandte API-Elemente

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.

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

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

Verwandte API-Elemente

Gibt die Grenzen des Bildlaufrechtecks des Ziels in Layoutkoordinaten zurück. Layoutmethoden sollten das Bildlaufrechteck des Ziels nicht direkt abrufen.

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

Verwandte API-Elemente

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

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

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

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente