ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
spark.layouts 

ConstraintLayout  - AS3 Flex

Paketspark.layouts
Klassepublic class ConstraintLayout
VererbungConstraintLayout Inheritance LayoutBase Inheritance OnDemandEventDispatcher Inheritance Object
Unterklassen FormItemLayout

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Die ConstraintLayout-Klasse ordnet die Layoutelemente je nach individuellen Einstellungen und einer Reihe von durch Beschränkungsspalten und -zeilen definierten Beschränkungsbereichen an. Zwar können Sie mithilfe aller Eigenschaften und Beschränkungen von BasicLayout Elemente platzieren oder deren Größe ändern, jedoch gibt Ihnen ConstraintLayout die Möglichkeit, Layouts in Bezug auf gleichgeordnete Objekte durch Beschränkungselemente für die angegebenen Spalten und Zeilen zu erstellen.

Hinweis: Die listenbasierten Spark-Steuerelemente (das Spark List-Steuerelement und seine Unterklassen wie ButtonBar, ComboBox, DropDownList und TabBar) unterstützen nicht die Verwendung der ConstraintLayout-Klasse. Verwenden Sie ConstraintLayout nicht für listenbasierte Spark-Steuerelemente.

Die pro Element unterstützten Beschränkungen umfassen: left, right, top, bottom, baseline, percentWidth und percentHeight. Die minimale und maximale Größe des Elements wird immer berücksichtigt.

Spalten und Zeilen haben möglicherweise eine explizite Größe oder eine Inhaltsgröße (keine explizite Größe). Bereiche mit expliziter Größe werden auf ihre jeweils angegebene Größe gesperrt. Dagegen werden Bereiche mit Inhaltsgröße so angepasst, dass sie nur an die Elemente angepasst werden, die auf sie beschränkt sind. Wenn ein Element sich über mehrere Bereiche mit Inhaltsgröße erstreckt, wird der Bereich gleichmäßig unter den Bereichen mit Inhaltsgröße aufgeteilt.

Die gemessene Größe des Containers wird auf Grundlage der Elemente, ihrer Beschränkungen, ihrer bevorzugten Größen sowie der Größe von Zeilen und Spalten berechnet. Die Größe einer jeden Zeile und Spalte reicht gerade aus, damit alle auf sie beschränkten Elemente in der jeweils bevorzugten Größe darin enthalten sein können. Die gemessene Größe des Containers reicht aus, damit alle Spalten und Zeilen sowie alle anderen Elemente in ihrer jeweils bevorzugten Größe und unter Erfüllung ihrer Beschränkungen darin enthalten sein können.

Während eines Aufrufs der updateDisplayList()-Methode wird die Größe von jedem Element wie folgt bestimmt, wobei die Regeln nach Priorität aufgeführt sind (die minimale und maximale Höhe des Elements werden immer berücksichtigt):

  • Wenn für das Element percentWidth oder percentHeight festgelegt ist, wird die zugehörige Größe als Prozentsatz der verfügbaren Größe berechnet. Die verfügbare Größe entspricht der Größe des Bereichs oder Containers ggf. abzüglich der Beschränkungen für left, right, top oder bottom.
  • Wenn für das Element Beschränkungen für links und rechts eingestellt sind, wird dessen Breite auf die Breite des Containers bzw. des Bereichs abzüglich der Beschränkungen für left und right eingestellt.
  • Wenn für das Element Beschränkungen für top und bottom eingestellt sind, wird dessen Höhe auf die Höhe des Containers abzüglich der Beschränkungen für top und bottom eingestellt.
  • Das Element ist auf die bevorzugte Breite und/oder Höhe eingestellt.

Die Position des Elements wird entsprechend der Regeln in der folgenden Prioritätsreihenfolge bestimmt:

  • Wenn die Grundlinie eines Elements angegeben ist, wird das Element in der vertikalen Richtung platziert, sodass die zugehörige baselinePosition (normalerweise die Grundlinie der ersten Textzeile) an der Beschränkung für die baseline ausgerichtet ist.
  • Wenn Beschränkungen für top oder left für das Element angegeben sind, wird das Element so platziert, dass die linke obere Ecke der Layoutgrenzen des Elements von der linken oberen Ecke des Containers um den angegebenen Wert versetzt ist.
  • Wenn Beschränkungen für bottom oder right für das Element angegeben sind, wird das Element so platziert, dass die rechte untere Ecke der Layoutgrenzen des Elements von der rechten unteren Ecke des Containers um den angegebenen Wert versetzt ist.
  • Wenn die Position in horizontaler oder vertikaler Richtung durch keine Beschränkungen bestimmt wird, wird das Element entsprechend den x- und y-Koordinaten platziert.

Die Inhaltsgröße des Containers wird als Höchstwert der Koordinaten der rechten unteren Ecke aller Layoutelemente und Beschränkungsbereiche berechnet.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedclipAndEnableScrolling : Boolean
Mit „true“ wird angegeben, dass die untergeordneten Elemente auf die Begrenzungen des Viewports gekürzt werden.
LayoutBase
  constraintColumns : Vector.<ConstraintColumn>
Ein Vektor von ConstraintColumn-Instanzen, die diesen Zielcontainer partitionieren.
ConstraintLayout
  constraintRows : Vector.<ConstraintRow>
Ein Vektor von ConstraintRow-Instanzen, die diesen Zielcontainer partitionieren.
ConstraintLayout
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheriteddropIndicator : DisplayObject
Das von diesem Layout für den Dropindikator bei Drag & Drop-Vorgängen verwendete DisplayObject.
LayoutBase
 InheritedhorizontalScrollPosition : 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
 Inheritedtarget : GroupBase
Der GroupBase-Container, dessen Elemente von diesem Layout gemessen und platziert werden und deren Größe geändert wird.
LayoutBase
 InheritedtypicalLayoutElement : ILayoutElement
In Layouts verwendet, wenn feste Zeilen- bzw. Spaltengrößen angefordert sind, jedoch keine bestimmte Größe angegeben ist.
LayoutBase
 InheriteduseVirtualLayout : Boolean
Ein Container kann eine beliebige Anzahl an untergeordneten Objekten definieren.
LayoutBase
 InheritedverticalScrollPosition : 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
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
ConstraintLayout
 Inherited
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
 Inherited
Berechnet die Ablageposition im Datenprovider des Ablageziels für den angegebenen dragEvent.
LayoutBase
 Inherited
Ist useVirtualLayout „true“, kann diese Methode vom Layoutziel verwendet werden, um zwischengespeicherte Layoutinformationen zu löschen, wenn sich das Ziel ändert.
LayoutBase
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
OnDemandEventDispatcher
 Inherited
Wird vom Ziel aufgerufen, nachdem ein Layoutelement hinzugefügt wurde und bevor die Größe und Anzeigeliste des Ziels überprüft wurden.
LayoutBase
 Inherited
Diese Methode muss vom Ziel aufgerufen werden, nachdem ein Layoutelement entfernt wurde und bevor die Größe und Anzeigeliste des Ziels validiert werden.
LayoutBase
 Inherited
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
 Inherited
Gibt die Änderung der horizontalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten.
LayoutBase
 Inherited
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
 Inherited
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
 Inherited
Gibt die Änderung der vertikalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten.
LayoutBase
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
OnDemandEventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
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
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Misst die Standardgröße des Ziels auf Grundlage des Inhalts und misst optional die standardmäßige minimale Größe des Ziels.
LayoutBase
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
OnDemandEventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Platziert den Dropindikator und verändert dessen Größe anhand der angegebenen Ablageposition und ist sein übergeordnetes Element.
LayoutBase
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Platziert die Elemente des Ziels und ändert deren Größe.
LayoutBase
 Inherited
Wird vom Ziel am Ende der updateDisplayList()-Methode aufgerufen, damit das Layout das scrollRect aktualisiert.
LayoutBase
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
OnDemandEventDispatcher
Geschützte Methoden
 MethodeDefiniert von
 Inherited
Berechnet die Länge des erforderlichen Bildlaufs für die angegebene dropLocation während eines Drag & Drop-Vorgangs.
LayoutBase
 Inherited
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
 Inherited
Berechnet die Grenzen des Dropindikators, der dem Benutzer anzeigt, wo die Objekte am Ende eines Drag & Drop-Vorgangs eingefügt werden.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet.
LayoutBase
 Inherited
Gibt die Grenzen des Bildlaufrechtecks des Ziels in Layoutkoordinaten zurück.
LayoutBase
  
layoutContent(unscaledWidth:Number, unscaledHeight:Number):void
Erstellt ein Layout der Elemente für das Layoutziel unter Verwendung der aktuellen Breiten und Höhen der Spalten und Zeilen.
ConstraintLayout
  
measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Wird von FormItemLayout verwendet, um neue Spaltenbreiten bzw. Zeilenhöhen abzumessen und festzulegen, bevor das Layout für die Elemente erstellt werden kann.
ConstraintLayout
 Inherited
Wird aufgerufen, wenn sich die verticalScrollPosition- oder horizontalScrollPosition-Eigenschaft ändert.
LayoutBase
Eigenschaftendetails

constraintColumns

Eigenschaft
constraintColumns:Vector.<ConstraintColumn>

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Vektor von ConstraintColumn-Instanzen, die diesen Zielcontainer partitionieren. Die ConstraintColumn-Instanz an Indexposition 0 ist die linke äußerste Spalte. Die Indexpositionen nehmen von links nach rechts zu.



Implementierung
    public function get constraintColumns():Vector.<ConstraintColumn>
    public function set constraintColumns(value:Vector.<ConstraintColumn>):void

constraintRows

Eigenschaft 
constraintRows:Vector.<ConstraintRow>

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Vektor von ConstraintRow-Instanzen, die diesen Zielcontainer partitionieren. Die ConstraintRow-Instanz an Indexposition 0 ist die oberste Spalte. Die Indexpositionen nehmen von oben nach unten zu.



Implementierung
    public function get constraintRows():Vector.<ConstraintRow>
    public function set constraintRows(value:Vector.<ConstraintRow>):void
Konstruktordetails

ConstraintLayout

()Konstruktor
public function ConstraintLayout()

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor.

Methodendetails

layoutContent

()Methode
protected function layoutContent(unscaledWidth:Number, unscaledHeight:Number):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt ein Layout der Elemente für das Layoutziel unter Verwendung der aktuellen Breiten und Höhen der Spalten und Zeilen. Wird von FormItemLayout nach dem Festlegen neuer Spaltenbreiten verwendet, um Elemente mit diesen neuen Breiten anzuordnen.

Parameter

unscaledWidth:Number — Legt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente.
 
unscaledHeight:Number — Legt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente.

measureAndPositionColumnsAndRows

()Methode 
protected function measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 1.5

Wird von FormItemLayout verwendet, um neue Spaltenbreiten bzw. Zeilenhöhen abzumessen und festzulegen, bevor das Layout für die Elemente erstellt werden kann.

Parameter

constrainedWidth:Number (default = NaN) — Die Gesamtbreite, die zum Dehnen oder Verkleinern von Spalten mit prozentualer Breite zur Verfügung steht. Bei NaN sind die Spalten mit prozentualer Breite uneingeschränkt und ihrem Inhalt angepasst.
 
constrainedHeight:Number (default = NaN) — Die Gesamthöhe, die zum Dehnen oder Verkleinern von Zeilen mit prozentualer Höhe zur Verfügung steht. Bei NaN sind die Zeilen mit prozentualer Höhe uneingeschränkt und ihrem Inhalt angepasst.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.