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 

BasicLayout  - AS3 Flex

Paketspark.layouts
Klassepublic class BasicLayout
VererbungBasicLayout Inheritance LayoutBase Inheritance OnDemandEventDispatcher Inheritance 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:

  1. 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.
  2. 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-SyntaxexpandedMXML-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
 EigenschaftDefiniert von
 InheritedclipAndEnableScrolling : Boolean
Mit „true“ wird angegeben, dass die untergeordneten Elemente auf die Begrenzungen des Viewports gekürzt werden.
LayoutBase
 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.
BasicLayout
 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
 Inherited
Wird aufgerufen, wenn sich die verticalScrollPosition- oder horizontalScrollPosition-Eigenschaft ändert.
LayoutBase
Konstruktordetails

BasicLayout

()Konstruktor
public function BasicLayout()

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

Konstruktor.





[ 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.