BasicLayout

Paket	spark.layouts
Klasse	public class BasicLayout
Vererbung	BasicLayout LayoutBase OnDemandEventDispatcher Object
Unterklassen	StackLayout

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die BasicLayout-Klasse ordnet die Layoutelemente entsprechend ihrer Einstellungen und unabhängig voneinander an. BasicLayout, auch absolutes Layout genannt, erfordert, dass Sie jedes untergeordnete Element des Containers explizit positionieren. Für die Platzierung der untergeordneten Elemente können Sie dessen x- und y-Eigenschaften oder Beschränkungen verwenden.

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

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

Die gemessene Größe des Containers wird auf Grundlage der Elemente, ihrer Beschränkungen und ihrer bevorzugten Größen berechnet. Die gemessene Größe des Containers reicht aus, sodass alle Elemente in der bevorzugten Größe und mit erfüllten Beschränkungen darin enthalten sein können.

Im Folgenden sehen Sie anhand einiger Beispiele, wie die gemessene Größe berechnet wird:

Wenn der Container über ein einzelnes Element mit einer für left angegebenen Beschränkung verfügt, entspricht die gemessene Breite des Containers der bevorzugten Breite des Elements plus dem Wert der Beschränkung für left.
Wenn der Container über ein einzelnes Element mit angegebener percentWidth verfügt, entspricht die gemessene Breite des Containers der bevorzugten Breite des Elements. Obwohl die percentWidth des Elements in den Berechnungen nicht direkt berücksichtigt wird, wird sie beim Aufruf der updateDisplayList()-Methode berücksichtigt.
Wenn der Container über ein einzelnes Element mit einer Beschränkung für die baseline verfügt, entspricht die gemessene Höhe des Containers der bevorzugten Höhe des Elements plus der baseline abzüglich des Werts der baselinePosition-Eigenschaft des Elements.
Wenn der Container über ein einzelnes Element mit einer verticalCenter-Beschränkung verfügt, entspricht die gemessene Höhe des Containers der bevorzugten Höhe des Elements plus dem doppelten Wert der verticalCenter-Beschränkung.

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 bei dem Element die 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 Containergröße ggf. abzüglich der Beschränkungen für left, right, top und bottom.
Wenn für das Element Beschränkungen für links und rechts eingestellt sind, wird dessen Breite auf die Breite des Containers 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 BasicLayout-Klasse berechnet ihre Mindestgröße als das Maximum der Mindestgrößen untergeordneter Elemente:

Legen Sie für jedes untergeordnete Element im Container die Mindestgröße fest, auf die das Element schrumpfen darf:
- Ist das untergeordnete Element auf die Breite oder Höhe des übergeordneten Elements beschränkt, kann es auf die Mindestbreite bzw. -höhe schrumpfen. Verwenden Sie die Mindestgröße des untergeordneten Elements.
- Ist das untergeordnete Element nicht auf das übergeordnete Element beschränkt, wird die bevorzugte Größe beibehalten. Verwenden Sie die bevorzugte Größe des untergeordneten Elements.
Suchen Sie das Maximum der Größen aus Schritt 1.

Ist daher ein untergeordnetes auf sein übergeordnetes Element beschränkt, wird im Layout die Mindestgröße des untergeordneten Elements genutzt. Andernfalls wird die bevorzugte Größe des untergeordneten Elements genutzt, um die Mindestgröße für den Container zu berechnen.

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

Die horizontalCenter- bzw. verticalCenter-Beschränkungen geben den Abstand zwischen der Containermitte und der Elementmitte an. Setzen Sie die horizontalCenter- oder verticalCenter-Beschränkungen auf null, um das Element im Container in horizontaler oder vertikaler Richtung zu zentrieren.
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 berechnet.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <s:BasicLayout> tag inherits all of the tag attributes of its superclass and adds no additional tag attributes:

  <s:BasicLayout/>

Ö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
		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
		BasicLayout() Konstruktor.	BasicLayout
		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
		scrollPositionChanged():void Wird aufgerufen, wenn sich die verticalScrollPosition- oder horizontalScrollPosition-Eigenschaft ändert.	LayoutBase

Konstruktordetails

()

Konstruktor

public function BasicLayout()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Rechtliche Hinweise | Onlinedatenschutzerklärung

BasicLayout - AS3 Flex

Klassen x

BasicLayout