ConstraintLayout

Paket	spark.layouts
Klasse	public class ConstraintLayout
Vererbung	ConstraintLayout LayoutBase OnDemandEventDispatcher 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

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		clipAndEnableScrolling : 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
		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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ConstraintLayout() Konstruktor.	ConstraintLayout
		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
		calculateDropLocation(dragEvent:DragEvent):DropLocation Berechnet die Ablageposition im Datenprovider des Ablageziels für den angegebenen dragEvent.	LayoutBase
		clearVirtualLayoutCache():void Ist useVirtualLayout „true“, kann diese Methode vom Layoutziel verwendet werden, um zwischengespeicherte Layoutinformationen zu löschen, wenn sich das Ziel ändert.	LayoutBase
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	OnDemandEventDispatcher
		elementAdded(index:int):void Wird vom Ziel aufgerufen, nachdem ein Layoutelement hinzugefügt wurde und bevor die Größe und Anzeigeliste des Ziels überprüft wurden.	LayoutBase
		elementRemoved(index:int):void Diese Methode muss vom Ziel aufgerufen werden, nachdem ein Layoutelement entfernt wurde und bevor die Größe und Anzeigeliste des Ziels validiert werden.	LayoutBase
		getElementBounds(index:int):Rectangle 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
		getHorizontalScrollPositionDelta(navigationUnit:uint):Number 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
		getScrollPositionDeltaToElement(index:int):Point 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
		getVerticalScrollPositionDelta(navigationUnit:uint):Number Gibt die Änderung der vertikalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten.	LayoutBase
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		hideDropIndicator():void 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
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		measure():void Misst die Standardgröße des Ziels auf Grundlage des Inhalts und misst optional die standardmäßige minimale Größe des Ziels.	LayoutBase
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		showDropIndicator(dropLocation:DropLocation):void Platziert den Dropindikator und verändert dessen Größe anhand der angegebenen Ablageposition und ist sein übergeordnetes Element.	LayoutBase
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		updateDisplayList(width:Number, height:Number):void Platziert die Elemente des Ziels und ändert deren Größe.	LayoutBase
		updateScrollRect(w:Number, h:Number):void Wird vom Ziel am Ende der updateDisplayList()-Methode aufgerufen, damit das Layout das scrollRect aktualisiert.	LayoutBase
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Ü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

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point Berechnet die Länge des erforderlichen Bildlaufs für die angegebene dropLocation während eines Drag & Drop-Vorgangs.	LayoutBase
		calculateDropIndex(x:Number, y:Number):int 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
		calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle Berechnet die Grenzen des Dropindikators, der dem Benutzer anzeigt, wo die Objekte am Ende eines Drag & Drop-Vorgangs eingefügt werden.	LayoutBase
		getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet.	LayoutBase
		getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet.	LayoutBase
		getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet.	LayoutBase
		getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet.	LayoutBase
		getScrollRect():Rectangle 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
		scrollPositionChanged():void 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

()

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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ConstraintLayout - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket spark.layouts

constraintColumns

constraintRows