mx.containersCanvas Ein Halo Canvas-Layoutcontainer definiert einen rechteckigen Bereich, in den Sie untergeordnete Container und Steuerelemente legen. The <mx:Canvas> tag inherits all the tag attributes of its superclass. Use the following syntax:

  <mx:Canvas>
    ...
      child tags
    ...
  </mx:Canvas>
  

]]>
mx.containers.utilityClasses:IConstraintLayoutmx.core:Container Ein Halo Canvas-Layoutcontainer definiert einen rechteckigen Bereich, in den Sie untergeordnete Container und Steuerelemente legen. Dies ist der einzige Container, in dem Sie explizit die Position seiner untergeordneten Objekte im Container festlegen können, indem Sie die x- und y-Eigenschaften jedes untergeordneten Objekts angeben.

Hinweis: Adobe empfiehlt, wenn immer möglich die Spark-Container mit BasicLayout anstelle des Halo Canvas-Containers zu verwenden.

Flex legt die untergeordneten Objekte eines Canvas-Layoutcontainers mit ihren bevorzugten Breiten und Höhen fest. Sie können den Wert für die bevorzugte Breite eines untergeordneten Objekts überschreiben, indem Sie seine Breite-Eigenschaft mit einem fixen Pixelwert oder einem Prozentsatz der Containergröße festlegen. Sie können die bevorzugte Höhe auf ähnliche Weise festlegen.

Wenn Sie die Größenbestimmung als Prozentwert in einem Canvas-Container verwenden, könnten einige Komponenten einander überlagern. Wenn Sie diesen Effekt nicht erzielen möchten, planen Sie die Positionen und Größen Ihrer Komponenten entsprechend.

Der Canvas-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Groß genug, damit alle untergeordneten Objekte mit ihrer Standardgröße darin Platz finden Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts
mx.components.ContainerCanvas Konstruktor. Konstruktor. measure Berechnet die bevorzugten Minimal- und Maximalgrößen des Canvas-Containers. Berechnet die bevorzugten Minimal- und Maximalgrößen des Canvas-Containers.

Die measuredWidth des Canvas-Containers ist gerade breit genug, um alle untergeordneten Objekte mit ihren bevorzugten Breiten anzuzeigen, ohne dass sie einander überlagern. Diese measure()-Methode berechnet die Position des am weitesten rechts liegenden untergeordneten Objekts und dann den rechten Rand dieses untergeordneten Objekts. Danach fügt sie entsprechend viel Platz für die Stärke des Canvas-Containerrahmens und zum Auffüllen am rechten Rand hinzu. Die measuredHeight wird ähnlich berechnet.

Die minWidth- und minHeight-Eigenschaften des Canvas-Containers werden nicht berechnet, daher verwendet Flex den Standardwert 0.

Die maxWidth- und maxHeight-Eigenschaften des Canvas-Containers werden nicht berechnet. Es wird angenommen, dass der Container eine unendliche maximale Breite und Höhe hat.

Alle vorstehend beschriebenen Werte sind gemessene Breiten und Höhen des Canvas-Containers. Der Benutzer kann die gemessenen Werte überschreiben, indem er explizit einen Wert für die folgenden Eigenschaften festlegt:

  • width
  • height
  • minWidth
  • minHeight
  • maxWidth
  • maxHeight

Sie sollten diese Methode nicht direkt aufrufen. Der Flex-LayoutManager ruft sie zum erforderlichen Zeitpunkt auf. Beim Start der Anwendung versucht der Flex-LayoutManager, alle Komponenten - von den untergeordneten bis zu den übergeordneten Objekten - zu messen, bevor er sie auf ihre endgültigen Größen festlegt.

Dies ist eine erweiterte Methode für die Verwendung von Unterklassen. Wenn Sie diese Methode überschreiben, muss Ihre Implementierung entweder die super.measure()-Methode oder die measuredHeight- und measuredWidth-Eigenschaften aufrufen. Sie können optional auch die folgenden Eigenschaften festlegen:

  • measuredMinWidth
  • measuredMinHeight
Diese Eigenschaften entsprechen den weiter oben angeführten Layouteigenschaften und werden daher nicht eigens dokumentiert.

updateDisplayList Legt die Größe jedes untergeordneten Objekts des Containers fest.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Legt die Größe jedes untergeordneten Objekts des Containers fest.

Der Canvas-Container ändert die Positionen seiner untergeordneten Objekte nicht. Jedes untergeordnete Objekt wird gemäß den Werten seiner x- und y-Eigenschaften platziert.

Der Canvas-Container richtet die Breite und Höhe jedes untergeordneten Objekts so ein, dass sie den measuredWidth- und measuredHeight-Werten dieses untergeordneten Objekts entsprechen, wenn keine width- und height-Werte festgelegt wurden. Das untergeordnete Objekt kann auch in der Größe veränderbar gemacht werden, indem die Werte für width und/oder height mit einem Prozentwert festgelegt werden. In der Größe veränderbare untergeordnete Objekte sind an den rechten und unteren Rand des Canvas-Containers gebunden. In diesem Fall werden die Werte minWidth, minHeight, maxWidth und maxHeight des untergeordneten Objekts berücksichtigt.

Sie sollten diese Methode nicht direkt aufrufen. Der Flex-LayoutManager ruft sie zum erforderlichen Zeitpunkt auf. Wenn die Anwendung startet, ruft der Flex-LayoutManager die updateDisplayList()-Methode für jede Komponente auf, wobei mit dem Application-Objekt begonnen und ab da weiterverarbeitet wird.

Dies ist eine erweiterte Methode für die Verwendung von Unterklassen. Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.updateDisplayList()-Methode und dann für jedes untergeordnete Objekt die move()- und setActualSize()-Methoden aufrufen. Für Layoutzwecke sollten Sie die Größe dieses Containers aus den unscaledWidth- und unscaledHeight-Eigenschaften abrufen und nicht aus den width- und height-Eigenschaften. Die width- und height-Eigenschaften berücksichtigen den Wert der scaleX- und scaleY-Eigenschaften für diesen Container nicht.

constraintColumns constraintRows
FormItemDirection Die FormItemDirection-Klasse definiert die Konstantenwerte für die direction-Eigenschaft der FormItem-Klasse.Object Die FormItemDirection-Klasse definiert die Konstantenwerte für die direction-Eigenschaft der FormItem-Klasse. mx.containers.FormItemHORIZONTAL Legt fest, dass die untergeordneten Objekte des FormItem-Containers horizontal angeordnet werden.horizontal Legt fest, dass die untergeordneten Objekte des FormItem-Containers horizontal angeordnet werden. VERTICAL Legt fest, dass die untergeordneten Objekte des FormItem-Containers vertikal angeordnet werden.vertical Legt fest, dass die untergeordneten Objekte des FormItem-Containers vertikal angeordnet werden. DividedBox Ein DividedBox-Container vermisst und platziert seine untergeordneten Objekte horizontal oder vertikal auf dieselbe Weise wie ein Box-Container, fügt aber ziehbare Trennlinien in die Lücken zwischen den untergeordneten Objekten ein.The <mx:DividedBox> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DividedBox
    Properties
    liveDragging="false|true"
    resizeToContent="false|true"
  
    Styles
    dividerAffordance="6"
    dividerAlpha="0.75"
    dividerColor="0x6F7777"
    dividerSkin="'mx.skins.BoxDividerSkin' symbol in Assets.swf"
    dividerThickness="3"
    horizontalDividerCursor="'mx.skins.cursor.HBoxDivider' symbol in Assets.swf"
    verticalDividerCursor="'mx.skins.cursor.VBoxDivider' symbol in Assets.swf"
 
    Events
    dividerPress="No default"
    dividerDrag="No default"
    dividerRelease="No default"
    >
      ...
      child tags
      ...
  </mx:DividedBox>
  
]]>
mx.containers:Box Ein DividedBox-Container vermisst und platziert seine untergeordneten Objekte horizontal oder vertikal auf dieselbe Weise wie ein Box-Container, fügt aber ziehbare Trennlinien in die Lücken zwischen den untergeordneten Objekten ein. Der Benutzer kann eine Trennlinie ziehen, um die Größe der untergeordneten Objekte auf beiden Seiten zu ändern.

Die DividedBox-Klasse ist die Basisklasse für die häufiger verwendeten HDividedBox- VDividedBox-Klassen.

Die direction-Eigenschaft eines DividedBox-Containers, die vom Box-Container geerbt wird, bestimmt, ob ein horizontales oder vertikales Layout vorliegt.

Ein DividedBox-, HDividedBox- oder VDividedBox-Container hat folgende Standardgrößeneigenschaften:

MerkmaleBeschreibung Standardgröße Vertical DividedBox Die Höhe reicht aus, damit alle untergeordneten Objekte mit ihren Standardhöhenwerten oder expliziten Höhenwerten plus vertikale Lücken zwischen den untergeordneten Objekten plus oberer und unterer Auffüllbereich des Containers untergebracht werden können. Die Breite ist die Standardbreite oder explizite Breite des breitesten untergeordneten Objekts plus der Auffüllbereich des Containers auf der linken und rechten Seite. Horizontal DividedBox Die Breite reicht aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten oder expliziten Breitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Auffüllbereich des Containers untergebracht werden können. Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Auffüllbereich des Containers. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts. Standardlückengröße 10 Pixel für die horizontalen und vertikalen Lücken.
mx.containers.HDividedBoxmx.containers.VDividedBoxdividerRelease Wird ausgelöst, wenn der Benutzer eine Trennlinie freigibt.mx.events.DividerEvent.DIVIDER_RELEASEmx.events.DividerEvent Wird ausgelöst, wenn der Benutzer eine Trennlinie freigibt. Das dividerRelease-Ereignis wird nach den dividerDrag-Ereignissen ausgelöst, aber bevor die Größen der untergeordneten Objekte des Containers angepasst werden. Die x- und y-Eigenschaften der Trennlinie werden erst aktualisiert, wenn das Ereignis ausgelöst wurde. Daher gibt ein Aufruf von hDividerBox.getDividerAt(0).x den Wert der ursprünglichen x-Position der ersten Trennlinie zurück. Wenn Sie die Position der Trennlinie nach der Bewegung ermitteln möchten, können Sie sie abrufen, nachdem das updateComplete-Ereignis der DividerBox ausgelöst wurde. dividerPress Ausgelöst, wenn der Benutzer eine Trennlinie in diesem Behälter anklickt.mx.events.DividerEvent.DIVIDER_PRESSmx.events.DividerEvent Ausgelöst, wenn der Benutzer eine Trennlinie in diesem Behälter anklickt. Das dividerPress-Ereignis wird vor allen dividerDrag-Ereignissen ausgelöst. dividerDrag Wird mehrere Male ausgelöst, wenn der Benutzer Trennlinien zieht.mx.events.DividerEvent.DIVIDER_DRAGmx.events.DividerEvent Wird mehrere Male ausgelöst, wenn der Benutzer Trennlinien zieht. Das dividerDrag-Ereignis wird nach dem dividerPress-Ereignis und vor dem dividerRelease-Ereignis ausgelöst. DividedBox Konstruktor. Konstruktor. getDividerAt Gibt einen Verweis auf das angegebene BoxDivider-Objekt in diesem DividedBox-Container zurück.Ein BoxDivider-Objekt. mx.containers.dividedBoxClasses:BoxDivideriAuf null basierende Indexposition einer Trennlinie, gerechnet von der linken Seite einer horizontalen DividedBox oder vom oberen Rand einer vertikalen DividedBox. Gibt einen Verweis auf das angegebene BoxDivider-Objekt in diesem DividedBox-Container zurück. moveDivider Verschiebt eine gegebene Trennlinie um die angegebene Anzahl von Pixeln.iAuf null basierende Indexposition einer Trennlinie, gerechnet von der linken Seite einer horizontalen DividedBox oder vom oberen Rand einer vertikalen DividedBox. amtDie Anzahl von Pixeln, um die die Trennlinie verschoben werden soll. Eine negative Zahl kann angegeben werden, um die Trennlinie nach oben oder nach links zu verschieben. Die Bewegung der Trennlinie ist genau so beschränkt wie wenn der Benutzer sie verschoben hätte. Verschiebt eine gegebene Trennlinie um die angegebene Anzahl von Pixeln. dividerClass Die Klasse für die Trennlinie zwischen den untergeordneten Objekten.mx.containers.dividedBoxClasses.BoxDivider Die Klasse für die Trennlinie zwischen den untergeordneten Objekten. liveDragging Wenn „true“, wird die Größe von untergeordneten Objekten neben einer Trennlinie fortlaufend verändert, während der Benutzer sie zieht.falsefalse Wenn true, wird die Größe von untergeordneten Objekten neben einer Trennlinie fortlaufend verändert, während der Benutzer sie zieht. Wenn false, wird die Größe erst verändert, wenn der Benutzer die Trennlinie ablegt. numDividers Die Anzahl von Trennlinien. Die Anzahl von Trennlinien. Die Anzahl ist immer numChildren - 1. resizeToContent Wenn „true“, wird die Größe von DividedBox automatisch auf die Größe der untergeordneten Objekte angepasst.false Wenn true, wird die Größe von DividedBox automatisch auf die Größe der untergeordneten Objekte angepasst.
ApplicationControlBar Der ApplicationControlBar-Container enthält Komponenten, die globale Navigations- und Anwendungsbefehle für den Halo Application-Container bereitstellen. Ab Flex 4 ist die ApplicationControlBar-Komponente nicht mehr erforderlich. Verwenden Sie die controlBarContent-Eigenschaft der Spark Application-Klasse für das Festlegen der in den Steuerleistenbereich einzuschließenden Komponenten. Verwenden Sie die controlBarLayout-Eigenschaft der Spark Application-Klasse für das Festlegen des Layouts des Steuerleistenbereichs. The <mx:ApplicationControlBar> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes. Unlike the ControlBar container, it is possible to set the backgroundColor style for an ApplicationControlBar container.

  <mx:ApplicationControlBar
    Properties
    dock="false|true"
  
    Styles
    fillAlphas="[0, 0]"
    fillColors="[0xFFFFFF, 0xFFFFFF]"
    >
    ...
      child tags
    ...
  </mx:ApplicationControlBar>
  
]]>
mx.containers:ControlBar Der ApplicationControlBar-Container enthält Komponenten, die globale Navigations- und Anwendungsbefehle für den Halo Application-Container bereitstellen. Ein ApplicationControlBar-Container für einen Editor könnte beispielsweise Button-Steuerelemente zum Einstellen der Schriftstärke, ein ComboBox-Steuerelement zur Auswahl der Schriftart und ein MenuBar-Steuerelement zur Auswahl des Bearbeitungsmodus enthalten. In der Regel platziert Sie einen ApplicationControlBar-Container über dem Halo Application-Container.

Hinweis: Der Spark Application-Container unterstützt den ApplicationControlBar-Container nicht. Modifizieren Sie die Skin des Spark Application-Containers, um diese Funktionalität hinzuzufügen.

Der ApplicationControlBar-Container kann in einem der folgenden Modi sein:

  • Angedockter Modus: Die Leiste steht immer am oberen Rand des Zeichenbereichs der Anwendung und wird Teil des Chroms der Anwendung. Bildlaufleisten der Anwendung gelten nicht für die Komponente, daher bleibt sie immer über dem sichtbaren Bereich und die Leiste dehnt sich so aus, dass sie immer über die gesamte Breite der Anwendung läuft. Um eine angedockte Leiste zu erstellen, legen Sie den Wert der dock-Eigenschaft mit true fest.
  • Normaler Modus: Die Leiste kann überall in der Anwendung platziert werden, wird wie jede andere Komponente in der Größe angepasst und platziert und der Bildlauf erfolgt mit der Anwendung. Um eine normale Leiste zu erstellen, legen Sie den Wert der dock-Eigenschaft mit false fest (Standardwert).

Der ApplicationControlBar-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Auffüllbereich des Containers. Im normalen Modus reicht die Breite aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten oder expliziten Breitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Auffüllbereich des Containers untergebracht werden können. Im angedockten Modus entspricht die Breite der Anwendungsbreite. Wenn die Anwendung nicht breit genug ist, um alle Steuerelemente des ApplicationControlBar-Containers aufzunehmen, wird die Leiste abgeschnitten. Standardwert für die Auffüllung 5 Pixel für den Wert oben. 4 Pixel für den Wert unten. 8 Pixel für den Wert links und rechts.
mx.core.ApplicationApplicationControlBar Konstruktor. Konstruktor. dock Wenn „true“, wird damit festgelegt, dass der ApplicationControlBar-Container oben in der Anwendung angedockt wird.false Wenn true, wird damit festgelegt, dass der ApplicationControlBar-Container oben in der Anwendung angedockt sein soll. Wenn false, wird damit festgelegt, dass der ApplicationControlBar-Container wie jede andere Komponente in der Größe angepasst und platziert wird. Diese Eigenschaft wird unterstützt, wenn die Anwendung den Typ Application aufweist, sonst hat der Wert von dock keine Auswirkung.
HDividedBox Der HDividedBox-Container ordnet seine untergeordneten Objekte horizontal auf dieselbe Weise an wie der HBox-Container, fügt aber eine ziehbare Trennlinie in die Lücke zwischen jedem untergeordneten Objekt ein.The <mx:HDividedBox> tag inherits all of the tag attributes of its superclass except direction and adds no new tag attributes.

]]>
mx.containers:DividedBox Der HDividedBox-Container ordnet seine untergeordneten Objekte horizontal auf dieselbe Weise an wie der HBox-Container, fügt aber eine ziehbare Trennlinie in die Lücke zwischen jedem untergeordneten Objekt ein. Ein Benutzer kann eine Trennlinie ziehen, um den Bereich neu zu dimensionieren, der den untergeordneten Objekten zugewiesen wird. Das <mx:HDividedBox/>-Tag entspricht <mx:DividedBox direction=„horizontal“/>.

Ein HDividedBox-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Breite reicht aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten oder expliziten Breitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Auffüllbereich des Containers untergebracht werden können. Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Auffüllbereich des Containers. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts. Standardlückengröße 10 Pixel für die horizontalen und vertikalen Lücken.
mx.containers.DividedBoxmx.containers.VDividedBoxHDividedBox Konstruktor. Konstruktor.
Grid Ein Grid-Container ermöglicht Ihnen die Anordnung von untergeordneten Objekten als Zeilen und Spalten von Zellen, ähnlich wie in einer HTML-Tabelle.The <mx:Grid> tag inherits all of the tag attributes of its superclass, except the Box.direction property, and adds the following tag attributes:

  <mx:Grid
    Styles
    horizontalGap="8"
    verticalGap="6"
    >
      ...
    These child tags are examples only:
       <mx:GridRow id="row1">
        <mx:GridItem
          rowSpan="1"
          colSpan="1">
            <mx:Button label="Button 1"/>
        </mx:GridItem>
        ...
       </mx:GridRow>
    ...
  </mx:Grid>
  
]]>
mx.containers:Box Ein Grid-Container ermöglicht Ihnen die Anordnung von untergeordneten Objekten als Zeilen und Spalten von Zellen, ähnlich wie in einer HTML-Tabelle. Der Grid-Container enthält mindestens eine Zeile und jede Zeile enthält mindestens eine Zelle (oder mindestens ein Element). Sie verwenden die folgenden Tags, um ein Grid-Steuerelement zu definieren:
  • Das <mx:Grid>-Tag definiert einen Grid-Container.
  • Das <mx:GridRow>-Tag definiert eine Rasterzeile, die mindestens eine Zelle hat. Die Rasterzeile muss ein untergeordnetes Objekt des <Grid>-Tags sein.
  • Das <mx:GridItem>-Tag definiert eine Rasterzelle und muss ein untergeordnetes Objekt des <GridRow>-Tags sein. Das <mx:GridItem>-Tag kann eine Anzahl von untergeordneten Objekten enthalten.

Die Zellen in einer bestimmten Zeile sind gleich hoch, aber die Zeilen können unterschiedliche Höhen aufweisen. Die Zellen in einer bestimmten Spalte sind gleich breit, aber die Spalten können unterschiedliche Breiten aufweisen. Sie können eine unterschiedliche Anzahl von Zellen für jede Zeile oder Spalte des Grid-Containers definieren. Außerdem kann sich eine Zelle über mehrere Spalten oder Zeilen des Containers erstrecken.

Die Grid-, GridRow- und GridItem-Containers weisen folgende Merkmale für ihre Größenbestimmung auf:

MerkmaleBeschreibung Höhe des Rasters Die Summe der Standardhöhenwerte oder expliziten Höhenwerte aller Zeilen plus die Lücken zwischen Zeilen. Breite des Rasters Die Summe der Standardbreitenwerte oder expliziten Breitenwerte aller Spalten plus die Lücken zwischen Spalten. Höhe jeder Zeile und jeder Zelle Die Standardhöhe oder explizite Höhe des größten Elements in der Zeile. Wenn ein GridItem-Container keine explizite Höhe hat, entspricht seine Standardhöhe der Standardhöhe oder der expliziten Höhe des untergeordneten Objekts in der Zelle. Breite jeder Spalte und jeder Zelle Die Standardbreite oder explizite Breite des größten Elements in der Spalte. Wenn ein GridItem-Container keine explizite Breite hat, entspricht seine Standardbreite der Standardbreite oder der expliziten Breite des untergeordneten Objekts in der Zelle. Lücke zwischen Zeilen und Spalten Bestimmt durch die horizontalGap- und verticalGap-Eigenschaften für die Grid-Klasse. Der Standardwert für beide Lücken ist 6 Pixel. Standardwert für die Auffüllung 0 Pixel für die Werte oben, unten, links und rechts, für alle drei Containerklassen.
mx.containers.GridRowmx.containers.GridItemGrid Konstruktor. Konstruktor. measure Berechnet die bevorzugten, Minimal- und Maximalgrößen des Grid-Containers. Berechnet die bevorzugten, Minimal- und Maximalgrößen des Grid-Containers.

Diese Methode sollten Sie nicht direkt aufrufen. Es handelt sich um eine erweiterte Methode für die Verwendung bei Unterklassen. Der Flex-LayoutManger ruft die measure()-Methode zum geeigneten Zeitpunkt auf. Beim Start der Anwendung versucht der Flex-LayoutManager, alle Komponenten - von den untergeordneten bis zu den übergeordneten Objekten - zu messen, bevor er sie auf ihre endgültigen Größen festlegt.

Zum Verständnis der Berechnung der Messwerte durch den Grid-Container können Sie davon ausgehen, dass jeder GridItem-Container seine rowSpan-Eigenschaft und colSpan-Eigenschaft auf 1 gesetzt hat. Die gemessene Breite der ersten Spalte des Grid-Containers entspricht dem Maximum der gemessenen Breiten aller GridItem-Container in der ersten Spalte. Ebenso gilt: Die gemessene Breite der zweiten Spalte ist das Maximum aller gemessenen Breiten unter den GridItem-Containern in der zweiten Spalte, und so weiter. Die measuredWidth-Eigenschaft des gesamten Grid-Containers ist die Summe der gemessenen Breiten aller Spalten plus die Rahmenstärke, plus linker und rechter Auffüllbereich, plus der Raum für die horizontale Lücke zwischen nebeneinander liegenden Rasterzellen.

Die Eigenschaftswerte für measuredHeight, minWidth, minHeight, maxWidth und maxHeight werden alle auf ähnliche Weise berechnet, indem die Werte der Eigenschaften measuredHeight, minWidth etc. der GridItem-Container zusammengerechnet werden.

Wenn die colSpan-Eigenschaft eines GridItem-Containers 3 beträgt, wird die measuredWidth-Eigenschaft dieses GridItem-Containers über 3 Spalten geteilt. Wenn die measuredWidth-Eigenschaft gleichmäßig unterteilt wird, berechnet jede der drei Spalten ihre gemessene Breite so, als wäre der GridItem-Container nur in dieser Spalte und die measuredWidth-Eigenschaft des GridItem-Containers ein Drittel ihres aktuellen Werts.

Allerdings ist die measuredWidth-Eigenschaft des GridItem-Containers nicht immer gleichmäßig unter allen Spalten aufgeteilt, über die er sich erstreckt. Wenn einige Spalten eine Eigenschaft mit einem Prozentwert von width aufweisen, wird die measuredWidth-Eigenschaft des GridItem-Containers entsprechend geteilt, wobei versucht wird, jeder Spalte den angeforderten Prozentanteil des Grid-Containers zuzuweisen.

Alle vorstehend beschriebenen Werte sind gemessene Breiten und Höhen des Grid-Containers. Der Benutzer kann die gemessenen Werte überschreiben, indem er explizit einen Wert für die folgenden Eigenschaften festlegt:

  • minHeight
  • minWidth
  • maxHeight
  • maxWidth
  • height
  • width

Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.measure()-Methode oder die measuredHeight- und measuredWidth-Eigenschaften aufrufen. Sie können optional auch die folgenden Eigenschaften festlegen:

  • measuredMinWidth
  • measuredMinHeight

Diese Eigenschaften entsprechen den weiter oben angeführten Layouteigenschaften und werden daher nicht eigens dokumentiert.

updateDisplayList Legt die Größe und Position jedes untergeordneten Objekts des Grid-Containers fest.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Legt die Größe und Position jedes untergeordneten Objekts des Grid-Containers fest.

Diese Methode sollten Sie nicht direkt aufrufen. Es handelt sich um eine erweiterte Methode für die Verwendung bei Unterklassen. Der Flex-LayoutManger ruft die updateDisplayList-Methode zum geeigneten Zeitpunkt auf. Wenn die Anwendung startet, ruft der Flex-LayoutManager die updateDisplayList()-Methode für jede Komponente auf, wobei mit dem Root-Objekt begonnen und ab da weiterverarbeitet wird.

Der Grid-Container befolgt dieselben Layoutregeln wie der VBox-Container. Die Positionen und Größen der GridRow-Container werden auf dieselbe Art berechnet wie ein VBox-Container die Positionen und Größen seiner untergeordneten Objekte ermittelt. Ein GridRow-Container platziert daher seine GridItem-Container mit einem ähnlichen Layout-Algorithmus wie ein HBox-Container.

Der einzige Unterschied besteht darin, dass die GridRow-Containers untereinander koordinieren, sodass sie alle dieselben Positionen und Größen für ihre untergeordneten Objekte wählen (damit die Spalten des Grid-Containers ausgerichtet sind).

Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.updateDisplayList()-Methode und dann für jedes untergeordnete Objekt die move()- und setActualSize()-Methoden aufrufen. Für Layoutzwecke sollten Sie die Größe dieses Containers aus den unscaledWidth- und unscaledHeight-Eigenschaften abrufen und nicht aus den width- und height-Eigenschaften. Die width- und height-Eigenschaften berücksichtigen die Werte der scaleX- und scaleY-Eigenschaften für diesen Container nicht.

TileDirection Die TileDirection-Klasse definiert die Konstantenwerte für die direction-Eigenschaft des Tile-Containers.Object Die TileDirection-Klasse definiert die Konstantenwerte für die direction-Eigenschaft des Tile-Containers. mx.containers.TileHORIZONTAL Legt fest, dass die untergeordneten Objekte des Tile-Containers horizontal angeordnet werden, also mit der ersten Zeile beginnen.horizontal Legt fest, dass die untergeordneten Objekte des Tile-Containers horizontal angeordnet werden, also mit der ersten Zeile beginnen. VERTICAL Legt fest, dass die untergeordneten Objekte des Tile-Containers vertikal angeordnet werden, also mit der ersten Spalte beginnen.vertical Legt fest, dass die untergeordneten Objekte des Tile-Containers vertikal angeordnet werden, also mit der ersten Spalte beginnen. TabNavigator Der MX TabNavigator-Container erweitert den MX ViewStack-Container, indem ein TabBar-Container für die Navigation zwischen seinen untergeordneten Containern einbezogen wird.The <mx:TabNavigator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TabNavigator
    Styles
    fillAlphas="[0.60, 0.40, 0.75, 0.65]"
    fillColors="[0xFFFFFF, 0xCCCCCC, 0xFFFFFF, 0xEEEEEE]"
    firstTabStyleName="Value of the tabStyleName property"
    focusAlpha="0.4"
    focusRoundedCorners="tl tr bl br"
    horizontalAlign="left|center|right"
    horizontalGap="-1"
    lastTabStyleName="Value of the tabStyleName property"
    selectedTabTextStyleName="undefined"
    tabHeight="undefined"
    tabOffset="0"
    tabStyleName="Name of CSS style declaration that specifies styles for the tabs"
    tabWidth="undefined"
    >
      ...
      child tags
      ...
  </mx:TabNavigator>
  
]]>
mx.managers:IFocusManagerComponentmx.containers:ViewStack Der MX TabNavigator-Container erweitert den MX ViewStack-Container, indem ein TabBar-Container für die Navigation zwischen seinen untergeordneten Containern einbezogen wird.

Hinweis: Die direkt untergeordneten Elemente von MX-Navigatorcontainern müssen entweder MX-Layout- oder MX-Navigatorcontainer sein oder aber Spark-NavigatorContent-Container. Innerhalb eines Navigators können Sie nur den Spark-NavigatorContent-Container direkt verschachteln, nicht jedoch sonstige Steuerelemente oder Spark-Container. Es muss sich um untergeordnete Elemente eines untergeordneten MX-Containers handeln.

Wie bei einem ViewStack-Container enthält ein TabNavigator-Container eine Sammlung von untergeordneten Containern, in der jeweils nur ein untergeordnetes Objekt sichtbar ist. Flex erstellt automatisch einen TabBar-Container am oberen Rand des TabNavigator-Containers, wobei jeweils eine Registerkarte einem untergeordneten Container entspricht. Jede Registerkarte kann ihre eigene Beschriftung und ihr eigenes Symbol haben. Wenn der Benutzer auf eine Registerkarte klickt, wird der zugeordnete untergeordnete Container als ausgewähltes untergeordnetes Objekt des TabNavigator-Containers sichtbar.

Wenn Sie den aktuell sichtbaren untergeordneten Container ändern, können Sie die hideEffect-Eigenschaft des auszublendenden Containers und die showEffect-Eigenschaft des einzublendenden untergeordneten Containers verwenden, um einen Effekt auf die untergeordneten Container anzuwenden. Der TabNavigator-Container wartet den Abschluss des hideEffect-Vorgangs des auszublendenden untergeordneten Containers ab und blendet erst dann den neuen untergeordneten Container ein. Sie können einen laufenden Effekt abbrechen, indem Sie die selectedIndex-Eigenschaft des TabNavigator-Containers ändern, während ein Effekt läuft.

Um das Aussehen von Registerkarten in einem TabNavigator-Container zu definieren, können Sie Stileigenschaften in einem Tab-Selektor wie in dem folgenden Beispiel festlegen:

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|Tab {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }  
  </fx:Style>
  

Der Tab-Selektor definiert Werte in der verborgenen mx.controls.tabBarClasses.Tab-Klasse. Die Standardwerte für den Tab-Selektor werden in der Datei defaults.css definiert.

Sie können die Stile auch in einem Klassenselektor definieren, den Sie mit der tabStyleName-Stileigenschaft festlegen, zum Beispiel:

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|TabNavigator {
       tabStyleName:myTabStyle;
    }
 
    .myTabStyle {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }
  </fx:Style>
  

Ein TabNavigator-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Standardwerte oder expliziten Werte für Breite und Höhe des ersten untergeordneten Objekts plus die Registerkarten mit ihren Standardwerten oder expliziten Werten für Höhe und Breite. Die Standardhöhe der Registerkarte wird durch Schriftart, Schriftstil und Skin bestimmt, die auf den TabNavigator-Container angewendet sind. Regeln für die Größenänderung von Containern Standardmäßig wird die Größe der TabNavigator-Container nur einmal festgelegt, um sie an die Größe des ersten untergeordneten Containers anzupassen. Die Größe ändert sich nicht, wenn Sie zu anderen untergeordneten Objekten navigieren. Um eine Größenänderung eines TabNavigator-Containers zu erzwingen, wenn Sie zu einem anderen untergeordneten Container navigieren, müssen Sie die resizeToContent-Eigenschaft auf „true“ setzen. Layoutregeln für untergeordnete Objekte Wenn das untergeordnete Objekt größer ist als der TabNavigator-Container, wird es abgeschnitten. Wenn das untergeordnete Objekt kleiner ist als der TabNavigator-Container, wird es in der linken oberen Ecke des TabNavigator-Container angefügt. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.containers.ViewStackmx.controls.TabBarTabNavigator Konstruktor. Konstruktor. getTabAt Gibt die Registerkarte des TabBar-Steuerelements des Navigators an der angegebenen Indexposition zurück.Die Registerkarte an der angegebenen Indexposition. mx.controls:ButtonindexDie Indexposition im TabBar-Steuerelement des Navigators. Gibt die Registerkarte des TabBar-Steuerelements des Navigators an der angegebenen Indexposition zurück. measure Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte dieses TabNavigator-Containers. Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte dieses TabNavigator-Containers. Im Abschnitt über die UIComponent.measure()-Methode finden Sie weitere Hinweise zur measure()-Methode.

Der TabNavigator-Container benutzt dieselbe Messlogik wie der ViewStack-Container, mit zwei Änderungen: Zunächst wird der Wert der measuredHeight- und measuredMinHeight-Eigenschaften erhöht, um die Registerkarten unterzubringen. Zweitens wird der Wert der measuredWidth-Eigenschaft erforderlichenfalls erhöht, um sicherzustellen, dass jede Registerkarte mindestens 30 Pixel breit seit kann.

mx.core.UIComponent.measure()mx.containers.ViewStack.measure()
updateDisplayList Reagiert auf Größenänderungen, indem die Positionen und Größen der Registerkarten und untergeordneten Objekte dieses Containers festgelegt werden.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Reagiert auf Größenänderungen, indem die Positionen und Größen der Registerkarten und untergeordneten Objekte dieses Containers festgelegt werden. Weitere Hinweise zur updateDisplayList()-Methode finden Sie im Abschnitt über die UIComponent.updateDisplayList()-Methode.

Ein TabNavigator-Container platziert seinen TabBar-Container am oberen Rand. Die Breite des TabBar-Containers wird mit der Breite des TabNavigator-Containers festgelegt und die Höhe des TabBar-Containers wird an die tabHeight-Eigenschaft angepasst.

Ein TabNavigator-Container platziert und dimensioniert seine untergeordneten Container unter dem TabBar-Container und verwendet dabei dieselbe Logik wie im ViewStack-Container.

mx.core.UIComponent.updateDisplayList()
tabBar Ein Verweis auf den TabBar-Container in diesem TabNavigator-Container.mx.controls:TabBar Ein Verweis auf den TabBar-Container in diesem TabNavigator-Container. tabBarStyleFilters Die Gruppen von Stilen, die von TabNavigator an tabBar übergeben werden. Die Gruppen von Stilen, die von TabNavigator an tabBar übergeben werden. mx.styles.StyleProxy
HBox Der Halo HBox-Container ordnet seine untergeordneten Objekte in einer einzelnen horizontalen Zeile an. The <mx:HBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>
mx.containers:Box Der Halo HBox-Container ordnet seine untergeordneten Objekte in einer einzelnen horizontalen Zeile an. Sie verwenden das <mx:HBox>-Tag anstelle des <mx:Box>-Tags als Kurzbefehl, um das Festlegen der direction-Eigenschaft auf „horizontal“ zu vermeiden.

Hinweis: Adobe empfiehlt, wenn immer möglich die Spark-Container mit HorizontalLayout anstelle des Halo HBox-Containers zu verwenden.

Ein HBox-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Breite reicht aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten oder expliziten Breitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Füllbereich des Containers untergebracht werden können. Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Füllbereich des Containers. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.components.Containermx.containers.Boxmx.containers.VBoxHBox Konstruktor. Konstruktor.
VBox Der Halo VBox-Container ordnet seine untergeordneten Objekte in einer einzelnen vertikalen Spalte an. The <mx:VBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>
mx.containers:Box Der Halo VBox-Container ordnet seine untergeordneten Objekte in einer einzelnen vertikalen Spalte an. Sie verwenden das <mx:VBox>-Tag anstelle des <mx:Box>-Tags als Kurzbefehl, um das Festlegen der direction-Eigenschaft auf „vertical“ zu vermeiden.

Hinweis: Adobe empfiehlt, wenn immer möglich die Spark-Container mit VerticalLayout anstelle des Halo VBox-Containers zu verwenden.

Ein VBox-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe reicht aus, damit alle untergeordneten Objekte mit ihren Standardhöhenwerten oder expliziten Höhenwerten plus vertikale Lücken zwischen den untergeordneten Objekten plus oberer und unterer Füllbereich des Containers untergebracht werden können. Die Breite ist die Standardbreite oder explizite Breite des breitesten untergeordneten Objekts plus Auffüllbereich des Containers auf der linken und rechten Seite. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.components.Containermx.containers.Boxmx.containers.HBoxVBox Konstruktor. Konstruktor.
TitleWindow Ein TitleWindow-Layoutcontainer enthält eine Titelleiste, einen Titeltext, einen Rahmen und einen Inhaltsbereich für sein untergeordnetes Objekt. The <mx:TitleWindow> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TitleWindow
   Properties
   showCloseButton="false|true"
 
   Styles
   closeButtonDisabledSkin="'CloseButtonDisabled' symbol in Assets.swf"
   closeButtonDownSkin="'CloseButtonDown' symbol in Assets.swf"
   closeButtonOverSkin="'CloseButtonOver' symbol in Assets.swf"
   closeButtonUpSkin="'CloseButtonUp' symbol in Assets.swf"
  
   Events
   close="No default"
   >
    ...
      child tags
    ...
  />
  
]]>
mx.containers:Panel Ein TitleWindow-Layoutcontainer enthält eine Titelleiste, einen Titeltext, einen Rahmen und einen Inhaltsbereich für sein untergeordnetes Objekt. Im Allgemeinen verwenden Sie TitleWindow-Container, um Anwendungsmodule einzuschließen, die selbst Container sind. Formulare werden beispielsweise in einen TitleWindow-Container gesetzt. Wenn der Benutzer das Formular ausfüllt, können Sie den TitleWindow-Container programmgesteuert schließen oder dies dem Benutzer überlassen, indem er die Schaltfläche „Schließen“ betätigt.

Der TitleWindow-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe reicht aus, um alle untergeordneten Objekte im Inhaltsbereich mit den Standardhöhenwerten oder expliziten Höhenwerten der untergeordneten Objekte aufzunehmen, plus Titelleiste und Rahmen, plus vertikale Lücken zwischen den untergeordneten Objekten, plus oberer und unterer Füllbereich des Containers. Die Breite ist die Standardbreite oder die explizite Breite des breitesten untergeordneten Objekts, je nachdem, welche Breite größer ist, plus linker und rechter Füllbereich am Containerrahmen oder die Breite des Titeltexts. borders 10 Pixel für den Wert links und rechts. 2 Pixel für den Wert oben. 0 Pixel für den Wert unten. padding 4 Pixel für oben, unten, links und rechts.
mx.core.Applicationmx.managers.PopUpManagermx.containers.Panelclose Ausgelöst, wenn der Benutzer die Schaltfläche „Schließen“ betätigt.3985 mx.events.CloseEvent.CLOSEmx.events.CloseEventclose-Ereignis Ausgelöst, wenn der Benutzer die Schaltfläche „Schließen“ betätigt. TitleWindow Konstruktor. Konstruktor. showCloseButton Ob eine Schaltfläche „Schließen“ im TitleWindow-Container angezeigt werden soll oder nicht.3986 false Wenn „true“, wird die Schaltfläche „Schließen“ angezeigt. Ob eine Schaltfläche „Schließen“ im TitleWindow-Container angezeigt werden soll oder nicht. Der Standardwert lautet false. Auf true eingestellt, um die Schaltfläche „Schließen“ anzuzeigen. Beim Klick auf die Schaltfläche „Schließen“ wird ein close-Ereignis ausgelöst, der TitleWindow-Container wird aber nicht geschlossen. Sie müssen eine Prozedur für das close-Ereignis programmieren und den TitleWindow-Container darin schließen.
FormHeading Der FormHeading-Container wird verwendet, um eine Überschrift für eine Gruppe von Steuerelementen in einem Form-Container anzuzeigen.The <mx:FormHeading> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FormHeading
    Properties
    label=""
  
    Styles
    color="0x0B333C"
    disabledColor="0xAAB3B3"
    fontAntiAliasType="advanced|normal"
    fontFamily="Verdana"
    fontGridFitType="pixel|subpixel|none"
    fontSharpness="0"
    fontSize="12"
    fontStyle="normal|italic"
    fontThickness="0"
    fontWeight="normal|bold"
    indicatorGap="14"
    labelWidth="Calculated"
    leading="2"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    textAlign="Calculated"
    textDecoration="none|underline"
    textIndent="0"
  />
  
]]>
mx.core:UIComponent Der FormHeading-Container wird verwendet, um eine Überschrift für eine Gruppe von Steuerelementen in einem Form-Container anzuzeigen. Die linke Seite der Überschrift ist mit der linken Seite der Steuerelemente im Formular ausgerichtet. Sie können mehrere FormHeading-Container in einen Form-Container einschließen. mx.containers.Formmx.containers.FormItemFormHeading Konstruktor. Konstruktor. label Überschrifttext des Formulars. Überschrifttext des Formulars.
Accordion MX Accordion-Navigatorcontainer haben eine Sammlung von untergeordneten MX-Containern oder Spark-NavigatorContent-Containern, es ist jedoch jeweils nur einer sichtbar.The <mx:Accordion> tag inherits all of the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:Accordion
    Properties
    headerRenderer="IFactory"
    historyManagementEnabled="true|false"
    resizeToContent="false|true"
    selectedChild"A reference to the first child"
    selectedIndex="undefined"
  
    Styles
    headerHeight="depends on header font styles"
    headerStyleName="No default"
    horizontalGap="8"
    openDuration="250"
    openEasingFunction="undefined"
    paddingBottom="-1"
    paddingTop="-1"
    textRollOverColor="0xB333C"
    textSelectedColor="0xB333C"
    verticalGap="-1"
  
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:Accordion>
  
]]>
Mit dem Accordion-Container ist die Navigation zwischen verschiedenen untergeordneten Ansichten möglich mx.managers:IHistoryManagerClientmx.managers:IFocusManagerComponentmx.core:Container MX Accordion-Navigatorcontainer haben eine Sammlung von untergeordneten MX-Containern oder Spark-NavigatorContent-Containern, es ist jedoch jeweils nur einer sichtbar. Er erstellt und verwaltet Navigatorschaltflächen (Überschriften des Accordion-Containers), die Sie für die Navigation zwischen den untergeordneten Objekten verwenden. Eine Navigatorschaltfläche ist jeweils mit einem untergeordneten Container verknüpft und jede Navigatorschaltfläche gehört zu dem Accordion-Container, nicht zum untergeordneten Objekt. Wenn der Benutzer auf eine Navigatorschaltfläche klickt, wird der verknüpfte untergeordnete Container angezeigt. Für den Übergang zum neuen untergeordneten Objekt wird eine Animation verwendet, damit der Benutzer sieht, dass ein untergeordnetes Objekt aus- und ein anderes eingeblendet wird.

Hinweis: Die direkt untergeordneten Elemente von MX-Navigatorcontainern müssen entweder MX-Layout- oder MX-Navigatorcontainer sein oder aber Spark-NavigatorContent-Container. Innerhalb eines Navigators können Sie nur den Spark-NavigatorContent-Container direkt verschachteln, nicht jedoch sonstige Steuerelemente oder Spark-Container. Es muss sich um untergeordnete Elemente eines untergeordneten MX-Containers handeln.

Der Accordion-Container erweitert nicht den ViewStack-Container, implementiert aber alle seine Eigenschaften, Methoden, Stile und Ereignisse, wie selectedIndex und selectedChild.

Ein Accordion-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Breite und Höhe des derzeit aktiven untergeordneten Objekts. Regeln für die Größenänderung von Containern Accordion-Container werden standardmäßig nur einmal dimensioniert, um sie an die Größe des ersten untergeordneten Containers anzupassen. Die Größe ändert sich standardmäßig nicht, wenn Sie zu anderen untergeordneten Objekten navigieren. Um eine Größenänderung eines Accordion-Containers zu erzwingen, wenn Sie zu einem anderen untergeordneten Container navigieren, müssen Sie die resizeToContent-Eigenschaft auf „true“ setzen. Regeln für die Größenanpassung von untergeordneten Objekten Die Größe der untergeordneten Objekte ist ihre Standardgröße. Das untergeordnete Objekt wird abgeschnitten, wenn es größer ist als der Accordion-Container. Wenn das untergeordnete Objekt kleiner ist als der Accordion-Container, wird es in der linken oberen Ecke des Accordion-Containers angefügt. Standardwert für die Auffüllung -1 Pixel für oben, unten, links und rechts.
mx.containers.accordionClasses.AccordionHeaderchange Wird ausgelöst, wenn sich der ausgewählte untergeordnete Container ändert.3012 mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEventchange-Ereignis Wird ausgelöst, wenn sich der ausgewählte untergeordnete Container ändert. Accordion Konstruktor. Konstruktor. getHeaderAt Gibt einen Verweis auf die Navigator-Schaltfläche für einen untergeordneten Container zurück.Button-Objekt, das eine Navigatorschaltfläche darstellt. mx.controls:ButtonindexAuf null basierende Indexposition des untergeordneten Objekts. Gibt einen Verweis auf die Navigator-Schaltfläche für einen untergeordneten Container zurück. loadState stateStatus dieses Objekts zum Laden. Der Wert ist null, wenn der ursprüngliche Status der Anwendung geladen wird. saveState Der Status dieses Objekts. contentHeight Die Höhe des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Die Höhe des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Sie können diese Abrufmethode überschreiben, wenn Ihr Inhalt nicht den gesamten Bereich des Containers ausfüllt. contentWidth Die Breite des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Die Breite des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Sie können diese Abrufmethode überschreiben, wenn Ihr Inhalt nicht den gesamten Bereich des Containers ausfüllt. headerRenderer Eine Factory zum Erstellen der Navigationsschaltflächen für jedes untergeordnete Objekt.mx.core:IFactory Eine Factory zum Erstellen der Navigationsschaltflächen für jedes untergeordnete Objekt. Der Standardwert ist eine Factory, die eine mx.containers.accordionClasses.AccordionHeader-Klasse erstellt. Das erstellte Objekt muss eine Unterklasse der Button-Klasse sein und die mx.core.IDataRenderer-Schnittstelle implementieren. Die data-Eigenschaft wird auf den Inhalt eingestellt, der mit der Überschrift verknüpft ist. mx.containers.accordionClasses.AccordionHeaderhistoryManagementEnabled Wenn „true“, ermöglicht diese Eigenschaft die Verwaltung von Verlaufdaten in diesem Accordion-Container.true Wenn true, ermöglicht diese Eigenschaft die Verwaltung von Verlaufdaten in diesem Accordion-Container. Wenn der Benutzer von einem untergeordneten Objekt zu einem anderen navigiert, merkt sich der Browser, welche untergeordneten Objekte angesteuert wurden. Der Benutzer kann dann die Zurück- und Weiter-Schaltflächen des Browsers benutzen, um sich durch den Navigationsverlauf durchzuklicken. mx.managers.HistoryManagerresizeToContent Wenn „true“, ändert dieser Accordion-Container seine Größe automatisch entsprechend der Größe des untergeordneten Objekts.false Wenn true, ändert dieser Accordion-Container seine Größe automatisch entsprechend der Größe des untergeordneten Objekts. selectedChild Ein Verweis auf den derzeit sichtbaren untergeordneten Container.3401 mx.core:INavigatorContentLegt die untergeordnete Ansicht fest, die gerade angezeigt wird Ein Verweis auf den derzeit sichtbaren untergeordneten Container. Der Standardwert ist ein Verweis auf das erste untergeordnete Objekt. Wenn keine untergeordneten Objekte vorhanden sind, ist diese Eigenschaft null.

Hinweis: Sie können diese Eigenschaft nur in einer ActionScript-Anweisung einstellen, nicht in MXML.

selectedIndex Die auf null basierende Indexposition des derzeit sichtbaren untergeordneten Containers.3402 0 Gibt die Indexposition der untergeordneten Ansicht an, die gerade angezeigt wird Die auf null basierende Indexposition des derzeit sichtbaren untergeordneten Containers. Indexpositionen von untergeordneten Objekten bewegen sich im Bereich 0, 1, 2, ..., n - 1, wobei n die Anzahl untergeordneter Objekte ist. Der Standardwert ist 0 und entspricht dem ersten untergeordneten Objekt. Wenn keine untergeordneten Objekte vorhanden sind, ist diese Eigenschaft -1.
ControlBar Mit dem ControlBar-Container können Sie Steuerelemente an den unteren Rand von Halo Panel- oder Halo TitleWindow-Containern platzieren. Ab Flex 4 ist die ControlBar-Komponente nicht mehr erforderlich. Verwenden Sie die controlBarContent-Eigenschaft der Spark Panel-Klasse für das Festlegen der in den Steuerleistenbereich einzuschließenden Komponenten. Verwenden Sie die controlBarLayout-Eigenschaft der Spark Panel-Klasse für das Festlegen des Layouts des Steuerleistenbereichs. The <mx:ControlBar> tag inherits all the tag attributes but adds no additional attributes:

  <mx:ControlBar>
    ...
      child tags
    ...
  </mx:ControlBar>
  
]]>
mx.containers:Box Mit dem ControlBar-Container können Sie Steuerelemente an den unteren Rand von Halo Panel- oder Halo TitleWindow-Containern platzieren. Das <mx:ControlBar>-Tag muss das letzte untergeordnete Tag des schließenden Tags für den Halo Panel- oder Halo TitleWindow-Container sein.

Hinweis: Der Spark Panel-Container unterstützt den ControlBar-Container nicht. Modifizieren Sie die Skin des Spark Panel-Containers, um diese Funktionalität hinzuzufügen.

Der ControlBar-Container ist ein Box-Objekt mit einem Hintergrund und Standardstileigenschaften.

Ein ControlBar-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Füllbereich des Containers. Die Breite reicht aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten oder expliziten Breitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Füllbereich des Containers untergebracht werden können. Standardwert für die Auffüllung 10 Pixel für oben, unten, links und rechts.
mx.containers.PanelControlBar Konstruktor. Konstruktor.
GridItem Der GridItem-Container definiert eine Rasterzelle in einem GridRow-Container.The <mx:GridItem> tag must be a child of the <GridRow> tag, which defines a grid row. The <mx:GridItem> container inherits the tag attributes of its superclass, and adds the following tag attributes.

  <mx:Grid>
    <mx:GridRow>
      <mx:GridItem
        rowSpan="1"
        colSpan="1">
          child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>
  
]]>
mx.containers:HBox Der GridItem-Container definiert eine Rasterzelle in einem GridRow-Container. (Der GridRow-Container definiert hingegen eine Zeile in einem Grid-Container.) Der GridItem-Container kann eine beliebige Anzahl von untergeordneten Objekten enthalten, die wie in einem HBox-Container angeordnet sind. Wenn Sie das HBox-Layout nicht akzeptieren, erstellen Sie einen Container, beispielsweise einen VBox-Container, als untergeordnetes Objekt des GridItem-Steuerelements und setzen Sie andere Komponenten in diesen untergeordneten Container.

GridItem-Container haben die folgenden Merkmale für Standardgrößen:

MerkmaleBeschreibung Höhe jeder Zeile und jeder Zelle Die Standardhöhe oder explizite Höhe des größten Elements in der Zeile. Wenn ein GridItem-Container keine explizite Höhe hat, entspricht seine Standardhöhe der Standardhöhe oder der expliziten Höhe des untergeordneten Objekts in der Zelle. Breite jeder Spalte und jeder Zelle Die Standardbreite oder explizite Breite des größten Elements in der Spalte. Wenn ein GridItem-Container keine explizite Breite hat, entspricht seine Standardbreite der Standardbreite oder der expliziten Breite des untergeordneten Objekts in der Zelle. Lücke zwischen Zeilen und Spalten Bestimmt durch die horizontalGap- und verticalGap-Eigenschaften für die Grid-Klasse. Der Standardwert für beide Lücken ist 6 Pixel. Standardwert für die Auffüllung 0 Pixel für die Werte oben, unten, links und rechts, für alle drei Containerklassen.
mx.containers.Gridmx.containers.GridRowGridItem Konstruktor. Konstruktor. colSpan Anzahl der Spalten des Grid-Containers, über die sich die Zelle erstreckt.1 Anzahl der Spalten des Grid-Containers, über die sich die Zelle erstreckt. rowSpan Anzahl der Zeilen des Grid-Containers, über die sich die Zelle erstreckt.1 Anzahl der Zeilen des Grid-Containers, über die sich die Zelle erstreckt. Sie können eine Zelle nicht über die Anzahl der Zeilen im Raster hinaus erweitern.
Panel Ein Halo Panel-Container enthält eine Titelleiste, einen Titeltext, einen Rahmen und einen Inhaltsbereich für seine untergeordneten Objekte. Legt den Effekt fest, der ausgeführt werden soll, bevor ein Resize-Effekt startet. Um den Standard-Dissolve-Effekt zu deaktivieren, damit die untergeordneten Objekte sofort ausgeblendet werden, legen Sie die resizeStartEffect-Eigenschaft mit „none“ fest. "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 Legt den Effekt fest, der ausgeführt werden soll, nachdem ein Resize-Effekt abgeschlossen wird. Um den Standard-Dissolve-Effekt zu deaktivieren, damit die untergeordneten Objekte sofort ausgeblendet werden, legen Sie die resizeEndEffect-Eigenschaft mit „none“ fest. "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 The <mx:Panel> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:Panel
   Properties
   layout="vertical|horizontal|absolute"
   status=""
   title=""
   titleIcon="null"
  
   Styles
   borderAlpha="0.4"
   borderThicknessBottom="NaN"
   borderThicknessLeft="10"
   borderThicknessRight="10"
   borderThicknessTop="2"
   controlBarStyleName="null"
   cornerRadius="4"
   dropShadowEnabled="true|false"
   footerColors="null"
   headerColors="null"
   headerHeight="Based on style of title"
   highlightAlphas="[0.3,0]"
   horizontalAlign="left|center|right"
   horizontalGap="8"
   modalTransparency="0.5"
   modalTransparencyBlur="3"
   modalTransparencyColor="#DDDDDD"
   modalTransparencyDuration="100"
   paddingBottom="0"
   paddingTop="0"
   roundedBottomCorners="false|true"
   shadowDirection="center|left|right"
   shadowDistance="2"
   statusStyleName="windowStatus"
   titleBackgroundSkin="TitleBackground"
   titleStyleName="windowStyles"
   verticalAlign="top|middle|bottom"
   verticalGap="6"
  
   Effects
   resizeEndEffect="Dissolve"
   resizeStartEffect="Dissolve"
   >
      ...
      child tags
      ...
  </mx:Panel>
  
]]>
mx.containers.utilityClasses:IConstraintLayoutmx.core:IFontContextComponentmx.core:Container Ein Halo Panel-Container enthält eine Titelleiste, einen Titeltext, einen Rahmen und einen Inhaltsbereich für seine untergeordneten Objekte. Im Allgemeinen verwenden Sie Panel-Container, um oberste Anwendungsmodule einzuschließen. In einen Panel-Container können Sie beispielsweise einen Einkaufswagen setzen.

Hinweis: Adobe empfiehlt, wenn immer möglich den Spark Panel-Container anstelle des Halo Panel-Containers zu verwenden.

Der Panel-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe ist groß genug, um alle untergeordneten Objekte mit ihrer Standardhöhe aufzunehmen, plus vertikale Lücken zwischen den untergeordneten Objekten, obere und untere Auffüllung, obere und untere Rahmenlinien und Titelleiste. Die Breite ist entweder der Wert der Standardbreite des breitesten untergeordneten Objekts plus linke und rechte Auffüllung des Containers, oder die Breite des Titeltexts, je nachdem, welcher Wert größer ist, plus Rahmen. Auffüllen 4 Pixel für oben, unten, links und rechts.
spark.components.Panelmx.containers.ControlBarmx.containers.VBoxPanel Konstruktor. Konstruktor. getHeaderHeight Gibt die Höhe der Kopfleiste zurück.Die Höhe der Kopfleiste in Pixeln. Gibt die Höhe der Kopfleiste zurück. measure Berechnet die Standard-Minimal- und Maximalgrößen des Panel-Containers. Berechnet die Standard-Minimal- und Maximalgrößen des Panel-Containers. Weitere Hinweise zur measure()-Methode finden Sie im Abschnitt über die UIComponent.measure()-Methode.

Die measure()-Methode ruft erst die VBox.measure()-Methode auf und gewährleistet dann, dass die measuredWidth- und measuredMinWidth-Eigenschaften breit genug sind, um den Titel und das ControlBar-Objekt anzuzeigen.

mx.core.UIComponent.measure()
startDragging Wird aufgerufen, wenn der Benutzer mit dem Ziehen eines Panel-Containers beginnt, der vom PopUpManager aufgerufen wurde.event Wird aufgerufen, wenn der Benutzer mit dem Ziehen eines Panel-Containers beginnt, der vom PopUpManager aufgerufen wurde. stopDragging Wird aufgerufen, wenn der Benutzer das Ziehen eines Panel-Containers beendet, der vom PopUpManager aufgerufen wurde. Wird aufgerufen, wenn der Benutzer das Ziehen eines Panel-Containers beendet, der vom PopUpManager aufgerufen wurde. controlBar Ggf. ein Verweis auf die Steuerleiste dieses Panel-Containers.mx.core:IUIComponent Ggf. ein Verweis auf die Steuerleiste dieses Panel-Containers. statusTextField Das UITextField-Substeuerelement, das den Status anzeigt.mx.core:IUITextField Das UITextField-Substeuerelement, das den Status anzeigt. Das Statusfeld ist ein untergeordnetes Objekt des titleBar-Substeuerelements. titleBartitleBar Das TitleBar-Substeuerelement, das die Titelleiste dieses Panel-Containers anzeigt.mx.core:UIComponent Das TitleBar-Substeuerelement, das die Titelleiste dieses Panel-Containers anzeigt. titleTextField Das UITextField-Substeuerelement, das den Titel anzeigt.mx.core:IUITextField Das UITextField-Substeuerelement, das den Titel anzeigt. Das Titelfeld ist ein untergeordnetes Objekt des titleBar-Substeuerelements. titleBarcloseButtonStyleFilters Die Gruppen von Stilen, die vom Panel-Container an die Schaltfläche „Schließen“ übergeben werden. Die Gruppen von Stilen, die vom Panel-Container an die Schaltfläche „Schließen“ übergeben werden. mx.styles.StyleProxyconstraintColumns constraintRows fontContext Die Modul-Factory, die den Schriftartkontext für diese Komponente bereitstellt.mx.core:IFlexModuleFactory Die Modul-Factory, die den Schriftartkontext für diese Komponente bereitstellt. layout Legt den Layoutmechanismus für diesen Container fest."vertical" Legt den Layoutmechanismus für diesen Container fest. Panel-Container können die Platzierung "vertical", "horizontal" oder "absolute" verwenden. Mit der vertikalen Platzierung werden die untergeordneten Komponenten vertikal vom oberen Rand des Containers bis zu seinem unteren Rand in der festgelegten Reihenfolge angeordnet. Mit der horizontalen Platzierung werden die untergeordneten Komponenten horizontal vom linken Rand des Containers bis zu seinem rechten Rand in der festgelegten Reihenfolge angeordnet. Bei der absoluten Platzierung wird kein automatisches Layout verwendet und Sie legen explizit den Standort jeder untergeordneten Komponente fest. status Text im Statusbereich der Titelleiste."" Text im Statusbereich der Titelleiste. titleIcon Das in der Titelleiste angezeigte Symbol.null Das in der Titelleiste angezeigte Symbol. title Titel oder Beschriftung in der Titelleiste.3991 "" Ruft den Titel oder die Beschriftung ab, die im Titel angezeigt werden, oder legt sie fest Titel oder Beschriftung in der Titelleiste.
Tile Ein Halo Tile-Container ordnet seine untergeordneten Objekte in einem Raster mit gleich großen Zellen an. Die layoutspezifischen Container-Komponenten in Flex 3 wurden durch eine allgemeinere Group-Komponente mit einem generischen Layout ersetzt. Um ein ähnliches Verhalten von der neuen Group-Komponente zu erhalten, setzen Sie die layout-Eigenschaft auf TileLayout oder verwenden Sie den TileGroup-Container. The <mx:Tile> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Tile
    Properties
    direction="horizontal|vertical"
    tileHeight="NaN"
    tileWidth="NaN"
 
    Sttles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
      ...
      child tags
     ...
  </mx:Tile>
  
]]>
mx.core:Container Ein Halo Tile-Container ordnet seine untergeordneten Objekte in einem Raster mit gleich großen Zellen an. Sie können die Größe der Zelle festlegen, indem Sie die tileWidth- und tileHeight-Eigenschaften verwenden, oder Sie können es dem Tile-Container überlassen, die Zellengröße basierend auf dem größten untergeordneten Objekt zu bestimmen. Die direction-Eigenschaft eines Tile-Containers bestimmt, ob seine Zellen horizontal oder vertikal angeordnet werden, wobei immer in der linken oberen Ecke des Tile-Containers begonnen wird.

Hinweis: Adobe empfiehlt, wenn immer möglich die Spark-Container mit TileLayout anstelle des Halo Tile-Containers zu verwenden.

Ein Tile-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Richtung horizontal Standardgröße aller Zellen Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts. Breite ist die Standardbreite oder explizite Breite des breitesten untergeordneten Objekts. Alle Zellen haben dieselbe Standardgröße. Standardgröße des Tile-Containers Flex berechnet die Quadratwurzel der Anzahl von untergeordneten Objekten und rundet auf die nächste Ganzzahl auf. Beispiel: Wenn 26 untergeordnete Objekte vorhanden sind, ist die Quadratwurzel 5,1 und daher erfolgt ein Aufrunden auf 6. Flex ordnet dann den Tile-Container mit einem Raster von 6 mal 6. Die Standardhöhe des Tile-Containers ist gleich (Tile-Zellenstandardhöhe) x (aufgerundete Quadratwurzel aus der Anzahl der untergeordneten Objekte), plus eventuelle Lücken zwischen den untergeordneten Objekten plus eventuelle Füllpixel. Die Standardbreite ist gleich (Tile-Zellenstandardbreite) x (aufgerundete Quadratwurzel aus der Anzahl der untergeordneten Objekte), plus eventuelle Lücken zwischen den untergeordneten Objekten plus eventuelle Füllpixel. Mindestgröße des Tile-Containers Die Standardgröße einer einzelnen Zelle. Flex weist immer genügend Speicherplatz zu, um mindestens eine Zelle anzuzeigen. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.components.ContainerTile Konstruktor. Konstruktor. measure Berechnet die Standard-Minimal- und Maximalgrößen des Tile-Containers. Berechnet die Standard-Minimal- und Maximalgrößen des Tile-Containers. Weitere Hinweise zur measure()-Methode finden Sie im Abschnitt über die UIComponent.measure()-Methode.

Diese Methode berechnet zuerst die Größe jeder einzelnen Zelle im Tile-Container. In den Abschnitten über die tileWidth- und tileHeight-Eigenschaften finden Sie eine Erklärung, wie diese Zellengröße bestimmt wird.

Die gemessene Größe eines Tile-Containers mit untergeordneten Objekten reicht aus, um die Zellen in einem n-mal-n-Raster mit einer gleichen Anzahl von Zeilen und Spalten anzuzeigen, plus Raum für die Füllpixel und die Rahmenlinien des Tile-Containers. Es gibt aber Sonderfälle wie in den nachfolgenden Beispielen:

  • Wenn für einen horizontalen Tile-Container eine explizite Breite eingestellt ist, legt dieser Wert fest, wie viele Zellen horizontal darin untergebracht werden können. Die erforderliche Höhe, damit alle untergeordneten Objekte hineinpassen, wird berechnet. Daraus ergibt sich ein M-mal-N-Raster.
  • Wenn für einen vertikalen Tile-Container eine explizite Höhe eingestellt ist, legt dieser Wert fest, wie viele Zellen vertikal darin untergebracht werden können. Die erforderliche Breite, damit alle untergeordneten Objekte untergebracht werden können, wird berechnet. Daraus ergibt sich ein M-mal-N-Raster.

Wenn keine untergeordneten Objekte vorhanden sind, ist die gemessene Größe gerade groß genug, um die Füllung und den Rahmen unterzubringen.

Die gemessene Mindestgröße eines Tile-Containers mit untergeordneten Objekten ist gerade groß genug für eine einzelne Tile-Zelle, plus Füllung und Rahmen. Wenn keine untergeordneten Objekte vorhanden sind, ist die gemessene Mindestgröße gerade groß genug, um die Füllung und den Rahmen unterzubringen.

mx.core.UIComponent.measure()
updateDisplayList Legt die Positionen und Größen der untergeordneten Objekte dieses Containers fest.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Legt die Positionen und Größen der untergeordneten Objekte dieses Containers fest. Weitere Hinweise zur updateDisplayList()-Methode finden Sie im Abschnitt über die UIComponent.updateDisplayList()-Methode.

Diese Methode platziert die untergeordneten Objekte im Schachbrettmuster mit gleich großen Zellen im Inhaltsbereich des Tile-Containers (also im Bereich innerhalb der Auffüllung). In den Abschnitten über die tileWidth- und tileHeight-Eigenschaften finden Sie eine Erklärung, wie diese Zellengröße ermittelt wird.

Die Trennung zwischen den Zellen wird durch die horizontalGap- und verticalGap-Stile festgelegt. Die Platzierung der einzelnen untergeordneten Objekte in ihrer Zelle wird durch die horizontalAlign- und verticalAlign-Stile festgelegt.

Der Fluss der untergeordneten Objekte wird durch die direction-Eigenschaft festgelegt. Die erste Zelle wird immer links oben in den Inhaltsbereich gesetzt. Wenn direction auf „horizontal“ eingestellt ist, werden die Zellen von links nach rechts in der obersten Zeile angeordnet, dann von links nach rechts in der zweiten Zeile, und so weiter. Wenn direction auf „vertikal“ eingestellt ist, werden die Zellen von oben nach unten in der äußerst linken Spalte angeordnet, dann von oben nach unten in der zweiten Spalte, und so weiter.

Wenn ein untergeordnetes Objekt einen percentWidth- oder percentHeight-Wert hat, wird es dieser Richtung neu dimensioniert, um den festgelegten Prozentsatz seiner Zelle auszufüllen.

mx.core.UIComponent.updateDisplayList()
direction Bestimmt, wie untergeordnete Objekte in den Container platziert werden."horizontal" Bestimmt, wie untergeordnete Objekte in den Container platziert werden. Mögliche MXML-Werte sind „horizontal“ und „vertical“. In ActionScript können Sie die Richtung mit den Werten TileDirection.HORIZONTAL oder TileDirection.VERTICAL einrichten. Der Standardwert ist „horizontal“. (Wenn der Container ein Legend-Container und damit eine Unterklasse von Tile ist, lautet der Standardwert „vertical“.)

Das erste untergeordnete Objekt wird immer in die linke obere Ecke des Tile-Containers gesetzt. Wenn direction auf „horizontal“ eingestellt ist, werden die untergeordneten Objekte von links nach rechts in der obersten Zeile angeordnet, dann von links nach rechts in der zweiten Zeile, und so weiter. Wenn direction auf „vertikal“ eingestellt ist, werden die untergeordneten Objekte von oben nach unten in der äußerst linken Spalte angeordnet, dann von oben nach unten in der zweiten Spalte, und so weiter.

TileDirection
tileHeight Die Höhe jeder Tile-Zelle in Pixeln.NaN Die Höhe jeder Tile-Zelle in Pixeln. Wenn diese Eigenschaft NaN lautet, wird der Standardwert für die Höhe jeder Zelle durch die Höhe des größten untergeordneten Objekts bestimmt. Wenn Sie diese Eigenschaft festlegen, überschreibt der festgelegte Wert diese Berechnung. tileWidth Die Breite jeder Tile-Zelle in Pixeln.NaN Die Breite jeder Tile-Zelle in Pixeln. Wenn diese Eigenschaft NaN lautet, wird die Breite jeder Zelle durch die Breite des größten untergeordneten Objekts bestimmt. Wenn Sie diese Eigenschaft festlegen, überschreibt der festgelegte Wert diese Berechnung.
VDividedBox Der VDividedBox-Container ordnet seine untergeordneten Objekte vertikal auf dieselbe Weise an wie der VBox-Container, fügt aber eine ziehbare Trennlinie in die Lücke zwischen jedem untergeordneten Objekt ein.The <mx:VDividedBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>
mx.containers:DividedBox Der VDividedBox-Container ordnet seine untergeordneten Objekte vertikal auf dieselbe Weise an wie der VBox-Container, fügt aber eine ziehbare Trennlinie in die Lücke zwischen jedem untergeordneten Objekt ein. Ein Benutzer kann eine Trennlinie ziehen, um den Bereich neu zu dimensionieren, der den untergeordneten Objekten zugewiesen wird. Das <mx:VDividedBox/>-Tag entspricht dem <mx:DividedBox direction=„vertical“/>-Tag.

Ein VDividedBox-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Höhe reicht aus, damit alle untergeordneten Objekte mit ihren Standardhöhenwerten oder expliziten Höhenwerten plus vertikale Lücken zwischen den untergeordneten Objekten plus oberer und unterer Auffüllbereich des Containers untergebracht werden können. Die Breite ist die Standardbreite oder explizite Breite des breitesten untergeordneten Objekts plus Auffüllbereich des Containers auf der linken und rechten Seite. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts. Standardlückengröße 10 Pixel für die horizontalen und vertikalen Lücken.
mx.containers.DividedBoxmx.containers.HDividedBoxVDividedBox Konstruktor. Konstruktor.
BoxDirection Die BoxDirection-Klasse legt Konstantenwerte für die „direction“-Eigenschaft des Box-Containers fest.Object Die BoxDirection-Klasse legt Konstantenwerte für die direction-Eigenschaft des Box-Containers fest. mx.containers.BoxHORIZONTAL Legt fest, dass die untergeordneten Objekte des Box-Containers horizontal angeordnet werden.horizontal Legt fest, dass die untergeordneten Objekte des Box-Containers horizontal angeordnet werden. VERTICAL Legt fest, dass die untergeordneten Objekte des Box-Containers vertikal angeordnet werden.vertical Legt fest, dass die untergeordneten Objekte des Box-Containers vertikal angeordnet werden. Form Mit dem Form-Container können Sie das Layout eines Formulars steuern, Formularfelder als erforderlich oder optional markieren, Fehlermeldungen verarbeiten und Ihre Formulardaten an das Flex-Datenmodell binden, um die Prüfung und Überprüfung von Daten vorzunehmen.The <mx:Form> tag inherits all the tag attributes of its superclass and adds the following tag attributes:

  <mx:Form
    Styles
    horizontalGap="8"
    indicatorGap="14"
    labelWidth="Calculated"
    paddingBottom="16"
    paddingTop="16"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Form>
  
]]>
mx.core:Container Mit dem Form-Container können Sie das Layout eines Formulars steuern, Formularfelder als erforderlich oder optional markieren, Fehlermeldungen verarbeiten und Ihre Formulardaten an das Flex-Datenmodell binden, um die Prüfung und Überprüfung von Daten vorzunehmen. Sie können dabei auch Stylesheets verwenden, um die Darstellung Ihrer Formulare zu konfigurieren.

Die folgende Tabelle beschreibt die Komponenten, die Sie für die Erstellung von Formularen in Flex verwenden:

KomponenteTagBeschreibung Form <mx:Form> Definiert den Container für das gesamte Formular, einschließlich des allgemeinen Formularlayouts. Verwenden Sie das FormHeading-Steuerelement und den FormItem-Container, um den Inhalt zu definieren. Sie können auch andere Arten von Komponenten in einen Form-Container einfügen. FormHeading <mx:FormHeading> Definiert eine Überschrift in Ihrem Formular. Sie können mehrere FormHeading-Container in ein Form-Steuerelement aufnehmen. FormItem <mx:FormItem> Enthält mindestens ein horizontal oder vertikal angeordnetes untergeordnetes Formularobjekt. Untergeordnete Objekte können Steuerelemente oder andere Container sein. Ein einzelner Form-Container kann mehrere FormItem-Container enthalten.
mx.containers.FormHeadingmx.containers.FormItemForm Konstruktor. Konstruktor. measure Berechnet die bevorzugten, Minimal- und Maximalgrößen des Form-Containers. Berechnet die bevorzugten, Minimal- und Maximalgrößen des Form-Containers. Weitere Hinweise zur measure-Methode finden Sie im Abschnitt über die UIComponent.measure()-Methode.

Die Form.measure()-Methode legt die measuredWidth-Eigenschaft mit der Breite des größten untergeordneten Objekts fest, plus die Werte der Stileigenschaften paddingLeft und paddingRight und die Breite des Rahmens.

Die measuredHeight-Eigenschaft wird mit der Summe der measuredHeight-Werte aller untergeordneten Objekte festgelegt, plus ein verticalGap-Zwischenraum zwischen jedem untergeordneten Objekt. Die Stileigenschaften paddingTop und paddingBottom sowie die Höhe des Rahmens werden ebenfalls hinzugefügt.

Die measuredMinWidth-Eigenschaft wird auf die größte Mindestbreite der untergeordneten Objekte eingestellt. Wenn das untergeordnete Objekt einen Prozentwert für width hat, wird die minWidth-Eigenschaft verwendet, sonst die measuredWidth-Eigenschaft. Die Werte der paddingLeft- und paddingRight-Stileigenschaften und die Breite des Rahmens werden ebenfalls hinzugefügt.

Die measuredMinHeight-Eigenschaft wird auf denselben Wert eingestellt wie die measuredHeight-Eigenschaft.

updateDisplayList Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden. Weitere Hinweise zur updateDisplayList()-Methode finden Sie im Abschnitt über die UIComponent.updateDisplayList()-Methode.

Die Form.updateDisplayList()-Methode platziert die untergeordneten Objekte in einer vertikalen Spalte, mit einem nach der verticalGap-Stileigenschaft festgelegten Zwischenraum. Die Stileigenschaften paddingLeft, paddingRight, paddingTop und paddingBottom werden angewendet.

Wenn ein untergeordnetes Objekt eine Prozentwertbreite hat, wird sie horizontal bis zum festgelegten Prozentsatz des Form-Containers gedehnt. Sonst wird sie mit ihrer measuredWidth-Eigenschaft eingestellt. Jedes untergeordnete Objekt wird auf seine measuredHeight-Eigenschaft eingestellt.

Diese Methode ruft zunächst und vor allem Anderen die super.updateDisplayList()-Methode auf.

maxLabelWidth Die Maximalbreite der Beschriftungen in den FormItems-Containern dieses Form-Containers in Pixeln. Die Maximalbreite der Beschriftungen in den FormItems-Containern dieses Form-Containers in Pixeln.
ViewStack Ein MX ViewStack-Navigatorcontainer besteht aus einer Sammlung von untergeordneten Containern, die übereinandergestapelt sind, wobei immer nur ein untergeordneter Container sichtbar ist.The <mx:ViewStack> tag inherits the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:ViewStack
    Properties
    historyManagementEnabled="false|true"
    resizeToContent="false|true"
    selectedIndex="0"
    
    Styles
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalGap="6"
    
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:ViewStack>
  
]]>
mx.managers:IHistoryManagerClientmx.core:ISelectableListmx.core:Container Ein MX ViewStack-Navigatorcontainer besteht aus einer Sammlung von untergeordneten Containern, die übereinandergestapelt sind, wobei immer nur ein untergeordneter Container sichtbar ist. Wenn ein anderer untergeordneter Container ausgewählt wird, scheint er den alten zu ersetzen, weil er an derselben Stelle erscheint. Der alte Container existiert aber immer noch. Er ist nur unsichtbar.

Hinweis: Die direkt untergeordneten Elemente von MX-Navigatorcontainern müssen entweder MX-Layout- oder MX-Navigatorcontainer sein oder aber Spark-NavigatorContent-Container. Innerhalb eines Navigators können Sie nur den Spark-NavigatorContent-Container direkt verschachteln, nicht jedoch sonstige Steuerelemente oder Spark-Container. Es muss sich um untergeordnete Elemente eines untergeordneten MX-Containers handeln.

Ein ViewStack-Container bietet keine Benutzeroberfläche für die Auswahl an, welcher untergeordnete Container gerade sichtbar ist. In der Regel legen Sie dies mit der selectedIndex- oder selectedChild-Eigenschaft in ActionScript als Reaktion auf eine Benutzereingabe fest. Für die Bereitstellung einer Navigationsschnittstelle können Sie auch einem ViewStack-Container ein MX LinkBar-, TabBar-, ButtonBar- oder ToggleButtonBar-Steuerelement oder ein Spark ButtonBar-Steuerelement zuordnen. Dazu legen Sie den ViewStack-Container als Wert der dataProvider-Eigenschaft des LinkBar-, TabBar- oder ToggleButtonBar-Containers fest.

Sie können entscheiden, einen komplexeren Navigatorcontainer als den ViewStack-Container zu verwenden, wie beispielsweise einen TabNavigator-Container oder einen Accordion-Container. Diese Container haben nicht nur eine Sammlung von untergeordneten Containern, sondern auch eigene Steuerelemente für die Navigation des Benutzers zwischen den untergeordneten Containern.

Wenn Sie den aktuell sichtbaren untergeordneten Container ändern, können Sie die hideEffect-Eigenschaft des auszublendenden Containers und die showEffect-Eigenschaft des einzublendenden untergeordneten Containers verwenden, um einen Effekt auf die untergeordneten Container anzuwenden. Der ViewStack-Container wartet den Abschluss des hideEffect-Vorgangs des auszublendenden untergeordneten Containers ab und blendet erst dann den neuen untergeordneten Container ein. Sie können einen laufenden Effekt abbrechen, indem Sie die selectedIndex-Eigenschaft des ViewStack-Containers ändern, während ein Effekt läuft.

Der ViewStack-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Die Breite und Höhe des ursprünglich aktiven untergeordneten Objekts. Regeln für die Größenänderung von Containern Standardmäßig wird die Größe der ViewStack-Containers nur einmal festgelegt, um sie an die Größe des ersten untergeordneten Containers anzupassen. Die Größe ändert sich nicht, wenn Sie zu anderen untergeordneten Objekten navigieren. Um eine Größenänderung eines ViewStack-Containers zu erzwingen, wenn Sie zu einem anderen untergeordneten Container navigieren, müssen Sie die resizeToContent-Eigenschaft auf „true“ setzen. Regeln für die Größenanpassung von untergeordneten Objekten Die Größe der untergeordneten Objekte ist ihre Standardgröße. Wenn das untergeordnete Objekt größer ist als der ViewStack-Container, wird es abgeschnitten. Wenn das untergeordnete Objekt kleiner ist als der ViewStack-Container, wird es in der linken oberen Ecke des ViewStack-Container angefügt. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.controls.LinkBarmx.controls.ButtonBarmx.controls.TabBarmx.controls.ToggleButtonBarspark.components.ButtonBarmx.managers.HistoryManagermx.managers.LayoutManagerchange Wird ausgelöst, wenn sich der ausgewählte untergeordnete Container ändert.mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEvent Wird ausgelöst, wenn sich der ausgewählte untergeordnete Container ändert. ViewStack Konstruktor. Konstruktor. commitSelectedIndex Übernimmt die ausgewählte Indexposition.newIndex Übernimmt die ausgewählte Indexposition. Diese Funktion wird während der Phase der Übernahme der Indexposition aufgerufen, wenn die Eigenschaft selectedIndex (oder selectedItem) geändert wurde. loadState stateStatus dieses Objekts zum Laden. Der Wert ist null, wenn der ursprüngliche Status der Anwendung geladen wird. measure Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte des ViewStack-Containers. Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte des ViewStack-Containers. Weitere Hinweise zur measure()-Methode finden Sie im Abschnitt über die UIComponent.measure()-Methode.

Die Standardgröße eines ViewStack-Containers ist die Standardgröße seines gerade ausgewählten untergeordneten Containers zuzüglich Auffüllung und Rahmen. Wenn der ViewStack-Container keine untergeordneten Container hat, ist seine Standardgröße gerade groß genug, um die Auffüllung und den Rahmen unterzubringen.

Die Mindestgröße eines ViewStack-Containers ist die Mindestgröße seines gerade ausgewählten untergeordneten Containers zuzüglich Auffüllung und Rahmen. Wenn der ViewStack-Container keine untergeordneten Container hat, ist seine Mindestgröße gerade groß genug, um die Auffüllung und Rahmen unterzubringen.

Diese Methode ändert die Maximalgröße eines ViewStack-Containers nicht - sie bleibt ohne Grenzen.

mx.core.UIComponent.measure()
saveState Der Status dieses Objekts. updateDisplayList Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden. Weitere Hinweise zur updateDisplayList()-Methode finden Sie im Abschnitt über die UIComponent.updateDisplayList()-Methode.

Es ist immer nur eines der untergeordneten Objekte sichtbar und daher platziert und dimensioniert ein ViewStack-Container nur dieses untergeordnete Objekt.

Das ausgewählte untergeordnete Objekt ist in der linken oberen Ecke des ViewStack-Containers platziert und enthält genügend Raum für die Auffüllung und Rahmen des ViewStack-Containers.

Wenn das ausgewählte untergeordnete Objekt einen Prozentsatz für width oder height hat, wird es in der Richtung neu dimensioniert, um den angegebenen Prozentsatz des Inhaltsbereichs des ViewStack-Containers (also der Bereich einschließlich des Ausfüllbereichs) auszufüllen.

mx.core.UIComponent.updateDisplayList()
contentHeight Die Höhe des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Die Höhe des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Sie können diese Abrufmethode überschreiben, wenn Ihr Inhalt nicht den gesamten Bereich des ViewStack-Containers ausfüllt. contentWidth Die Breite des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Die Breite des Bereichs, in dem Inhalt angezeigt wird, in Pixeln. Sie können diese Abrufmethode überschreiben, wenn Ihr Inhalt nicht den gesamten Bereich des ViewStack-Containers ausfüllt. contentX Die x-Koordinate des Bereichs des ViewStack-Containers, in dem der Inhalt angezeigt wird, in Pixeln. Die x-Koordinate des Bereichs des ViewStack-Containers, in dem der Inhalt angezeigt wird, in Pixeln. Der Standardwert ist gleich dem Wert der paddingLeft-Stileigenschaft, die den Standardwert 0 hat. Überschreiben Sie die get()-Methode, wenn Sie nicht möchten, dass Ihr Inhalt an der Layoutposition x = 0 beginnt. contentY Die y-Koordinate des Bereichs des ViewStack-Containers, in dem der Inhalt angezeigt wird, in Pixeln. Die y-Koordinate des Bereichs des ViewStack-Containers, in dem der Inhalt angezeigt wird, in Pixeln. Der Standardwert ist gleich dem Wert der paddingTop-Stileigenschaft, die den Standardwert 0 hat. Überschreiben Sie die get()-Methode, wenn Sie nicht möchten, dass Ihr Inhalt an der Layoutposition y = 0 beginnt. historyManagementEnabled Wenn „true“, wird die Verlaufverwaltung in diesem ViewStack-Container aktiviert.false Wenn true, wird die Verlaufverwaltung in diesem ViewStack-Container aktiviert. Wenn der Benutzer von einem untergeordneten Objekt zu einem anderen navigiert, merkt sich der Browser, welche untergeordneten Objekte angesteuert wurden. Der Benutzer kann dann die Zurück- und Weiter-Schaltflächen des Browsers benutzen, um sich durch den Navigationsverlauf durchzuklicken. mx.managers.HistoryManagerresizeToContent Wenn „true“, passt der ViewStack-Container seine Größe automatisch auf die Größe seines aktuellen untergeordneten Objekts an.false Wenn true, passt der ViewStack-Container seine Größe automatisch auf die Größe seines aktuellen untergeordneten Objekts an. selectedChild Ein Verweis auf den derzeit sichtbaren untergeordneten Container.mx.core:INavigatorContent Ein Verweis auf den derzeit sichtbaren untergeordneten Container. Der Standardwert ist ein Verweis auf das erste untergeordnete Objekt. Wenn keine untergeordneten Objekte vorhanden sind, ist diese Eigenschaft null.

Hinweis: Sie können diese Eigenschaft nur in einer ActionScript-Anweisung einstellen, nicht in MXML.

selectedIndex Die auf null basierende Indexposition des derzeit sichtbaren untergeordneten Containers. Die auf null basierende Indexposition des derzeit sichtbaren untergeordneten Containers. Indexpositionen von untergeordneten Objekten bewegen sich im Bereich 0, 1, 2, ..., n - 1, wobei n die Anzahl untergeordneter Objekte ist. Der Standardwert ist 0 und entspricht dem ersten untergeordneten Objekt. Wenn keine untergeordneten Objekte vorhanden sind, ist der Wert dieser Eigenschaft -1.

Hinweis: Wenn Sie ein neues untergeordnetes Objekt einem ViewStack-Container hinzufügen, wird die selectedIndex-Eigenschaft erforderlichenfalls automatisch angepasst, damit das ausgewählte untergeordnete Objekt ausgewählt bleibt.

GridRow Der GridRow-Container definiert eine Zeile in einem Grid-Container und enthält GridCell-Container.The <mx:GridRow> must be a child of the <mx:Grid> tag, and has one or more child <mx:GridItem> tags that define the grid cells.

The <mx:GridRow> container inherits the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Grid>
    <mx:GridRow
    Styles
      horizontalAlign="left|center|right"
      verticalAlign="top|middle|bottom"
    >
      <mx:GridItem
        child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>
  
]]>
mx.containers:HBox Der GridRow-Container definiert eine Zeile in einem Grid-Container und enthält GridCell-Container.

GridRow-Container haben die folgenden Merkmale für Standardgrößen:

MerkmaleBeschreibung Höhe jeder Zeile und jeder Zelle Die Standardhöhe oder explizite Höhe des größten Elements in der Zeile. Wenn ein GridItem-Container keine explizite Höhe hat, entspricht seine Standardhöhe der Standardhöhe oder der expliziten Höhe des untergeordneten Objekts in der Zelle. Breite jeder Spalte und jeder Zelle Die Standardbreite oder explizite Breite des größten Elements in der Spalte. Wenn ein GridItem-Container keine explizite Breite hat, entspricht seine Standardbreite der Standardbreite oder der expliziten Breite des untergeordneten Objekts in der Zelle. Lücke zwischen Zeilen und Spalten Bestimmt durch die horizontalGap- und verticalGap-Eigenschaften für die Grid-Klasse. Der Standardwert für beide Lücken ist 6 Pixel. Standardwert für die Auffüllung 0 Pixel für die Werte oben, unten, links und rechts, für alle drei Containerklassen.
mx.containers.Gridmx.containers.GridItemGridRow Konstruktor. Konstruktor. updateDisplayList Legt die Größe und Position jedes untergeordneten Objekts des GridRow-Containers fest.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Legt die Größe und Position jedes untergeordneten Objekts des GridRow-Containers fest. Weitere Hinweise zum Grid-Layoutalgorithmus finden Sie unter der Beschreibung der Grid.updateDisplayList()-Methode.

Sie sollten diese Methode nicht direkt aufrufen. Der Flex-LayoutManager ruft sie zum erforderlichen Zeitpunkt auf. Wenn die Anwendung startet, ruft der Flex-LayoutManager die updateDisplayList()-Methode für jede Komponente auf, wobei mit dem Root-Objekt begonnen und ab da weiterverarbeitet wird.

Dies ist eine erweiterte Methode für die Verwendung von Unterklassen. Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.updateDisplayList()-Methode und dann für jedes untergeordnete Objekt die move()- und setActualSize()-Methoden aufrufen. Für Layoutzwecke sollten Sie die Größe dieses Containers aus den unscaledWidth- und unscaledHeight-Eigenschaften abrufen und nicht aus den width- und height-Eigenschaften. Die width- und height-Eigenschaften berücksichtigen den Wert der scaleX- und scaleY-Eigenschaften für diesen Container nicht.

FormItem Der FormItem-Container definiert eine Beschriftung und mindestens ein untergeordnetes horizontal oder vertikal angeordnetes Objekt.The <mx:FormItem> tag inherits all of the tag attributes of its superclass, except paddingLeft, and adds the following tag attributes:

  <mx:FormItem
    Properties
    direction="vertical|horizontal"
    label=""
    required="false|true"
  
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    indicatorGap="14"
    indicatorSkin="'mx.containers.FormItem.Required' symbol in Assets.swf"
    labelStyleName=""
    labelWidth="Calculated"
    paddingBottom="0"
    paddingRight="0"
    paddingTop="0"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:FormItem>
  
]]>
mx.core:Container Der FormItem-Container definiert eine Beschriftung und mindestens ein untergeordnetes horizontal oder vertikal angeordnetes Objekt. Untergeordnete Objekte können Steuerelemente oder andere Container sein. Ein einzelner Form-Container kann mehrere FormItem-Container enthalten. mx.containers.Formmx.containers.FormItemDirectionmx.containers.FormHeadingmx.controls.FormItemLabelFormItem Konstruktor. Konstruktor. measure Berechnet die bevorzugten, Minimal- und Maximalgrößen des FormItem-Containers. Berechnet die bevorzugten, Minimal- und Maximalgrößen des FormItem-Containers. Im Abschnitt über die UIComponent.measure()-Methode finden Sie weitere Hinweise zur measure()-Methode.

Die FormItem.measure()-Methode bestimmt zuerst die Anzahl der zu verwendenden Spalten. Wenn die direction-Eigenschaft FormItemDirection.HORIZONTAL lautet, werden alle Steuerelemente in eine Zeile gesetzt, wenn dies möglich ist. Wenn die Steuerelemente nicht in eine einzige Zeile passen, werden sie in zwei Spalten aufgeteilt. Wenn dies nicht funktioniert, verwenden Sie eine einzelne Spalte. Wenn die direction-Eigenschaft FormItemDirection.VERTICAL lautet, werden die Steuerelemente in eine einzelne Spalte gesetzt (wie VBox).

Ein FormItem-Container enthält zwei Bereiche: Den Beschriftungsbereich und den Steuerelementbereich. Die Größe des Beschriftungsbereichs ist unabhängig von der Richtung der Steuerelemente identisch. Die Größe des Steuerelementbereichs hängt davon ab, wie viele Zeilen und Spalten verwendet werden.

Die Breite des Beschriftungsbereichs wird durch die labelWidth-Stileigenschaft bestimmt. Wenn diese Eigenschaft undefined ist (Standardvorgabe), wird die Breite der breitesten Beschriftung im übergeordneten Form-Container verwendet.

Wenn alle untergeordneten Objekte in einer einzigen Zeile stehen, ist die Breite des Steuerelementbereichs die Summe der Breiten aller untergeordneten Objekte zuzüglich des horizontalGap-Zwischenraums zwischen den untergeordneten Objekten.

Wenn sich die untergeordneten Objekte in einer einzigen Spalte befindet, ist die Breite des Steuerelementbereichs die Breite des breitesten untergeordneten Objekts.

Wenn sich die untergeordneten Objekte in mehreren Zeilen und Spalten befinden, ist die Breite des breitesten untergeordneten Objekts die Spaltenbreite und die Breite des Steuerelementbereichs ist die Spaltenbreite, multipliziert mit der Anzahl der Spalten zuzüglich des horizontalGap-Zwischenraums zwischen den Spalten.

measuredWidth wird auf die Breite des Beschriftungsbereichs plus die Breite des Steuerelementbereichs plus den Wert der indicatorGap-Stileigenschaft eingestellt. Die Werte der paddingLeft- und paddingRight-Stileigenschaften und die Breite des Rahmens werden ebenfalls hinzugefügt.

measuredHeight wird auf die Summe der bevorzugten Höhen aller Zeilen der untergeordneten Objekte plus verticalGap-Zwischenraum zwischen jedem untergeordneten Objekt eingestellt. Die Stileigenschaften paddingTop und paddingBottom sowie die Höhe des Rahmens werden ebenfalls hinzugefügt.

measuredMinWidth wird auf die Breite des Beschriftungsbereichs plus die Minimalbreite des Steuerelementbereichs plus den Wert der indicatorGap-Stileigenschaft eingestellt. Die Werte der paddingLeft- und paddingRight-Stileigenschaften und die Breite des Rahmens werden ebenfalls hinzugefügt.

measuredMinHeight wird auf die Summe der Minimalhöhen aller Zeilen der untergeordneten Objekte plus verticalGap-Zwischenraum zwischen jedem untergeordneten Objekt eingestellt. Die Stileigenschaften paddingTop und paddingBottom sowie die Höhe des Rahmens werden ebenfalls hinzugefügt.

updateDisplayList Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Reagiert auf Größenänderungen, indem die Positionen und Größen der untergeordneten Objekte dieses Container festgelegt werden. Im Abschnitt über die UIComponent.updateDisplayList()-Methode finden Sie weitere Hinweise zur updateDisplayList()-Methode.

Weitere Hinweise zur Platzierung der FormItem-Steuerelemente finden Sie unter der Beschreibung der FormItem.measure()-Methode.

Die Beschriftung wird im Beschriftungsbereich gemäß der textAlign-Stileigenschaft zentriert. Alle Beschriftungen in einem Formular sind aneinander ausgerichtet.

Wenn die required-Eigenschaft auf true eingestellt ist, wird ein Symbol, das das Feld als erforderlich kennzeichnet, zwischen die Beschriftung und die Steuerelemente gesetzt.

Die Steuerelemente sind in Spalten platziert, wie dies in der Dokumentation für die measure()-Methode beschrieben wird. Die horizontalAlign-Stileigenschaft bestimmt, wo die Steuerelemente horizontal platziert werden.

Wenn die direction-Eigenschaft „vertical“ lautet, verwendet jedes untergeordnete Objekt, für das width nicht festgelegt ist, die measuredWidth-Eigenschaft, aufgerundet auf die nächste 1/4-Breite des Steuerelementbereichs. Dies erfolgt, um am rechten Rand von Steuerelementen Zickzack-Muster zu vermeiden.

Diese Methode ruft zunächst und vor allem Anderen die super.updateDisplayList()-Methode auf.

direction Richtung der FormItem-Subkomponenten.FormItemDirection.VERTICAL Richtung der FormItem-Subkomponenten. Zulässige MXML-Werte sind „vertical“ oder „horizontal“. Der Standard-MXML-Wert ist „vertical“. Zulässige ActionScript-Werte sind FormItemDirection.VERTICAL oder FormItemDirection.HORIZONTAL.

Wenn direction auf „vertical“ eingestellt ist, werden die untergeordneten Objekte von FormItem vertikal rechts von der FormItem-Beschriftung gestapelt. Wenn direction auf „horizontal“ eingestellt ist, werden die untergeordneten Objekte in eine einzelne Zeile gesetzt (wenn sie passen) oder in zwei gleich große Spalten.

Wenn Sie das Layout von untergeordneten FormItem-Objekten besser steuern möchten, können Sie einen Container wie Grid oder Tile als direktes untergeordnetes Objekt von FormItem verwenden und die gewünschten Steuerelemente hineinsetzen.

mx.containers.FormItemDirection
itemLabel Ein schreibgeschützter Verweis auf die FormItemLabel-Subkomponente, die die Beschriftung von FormItem anzeigt.mx.controls:Label Ein schreibgeschützter Verweis auf die FormItemLabel-Subkomponente, die die Beschriftung von FormItem anzeigt. label Textbeschriftung für FormItem."" Textbeschriftung für FormItem. Diese Beschriftung erscheint links von den untergeordneten Komponenten im Formularelement. Die Position der Beschriftung wird durch die textAlign-Stileigenschaft gesteuert required Wenn auf „true“ gesetzt, wird mit einem Indikator angezeigt, dass für die untergeordneten Objekte des FormItem-Objekts Benutzereingaben erforderlich sind.false Wenn auf true gesetzt, wird mit einem Indikator angezeigt, dass für die untergeordneten Objekte des FormItem-Objekts Benutzereingaben erforderlich sind. Wenn auf false gesetzt, wird kein Indikator angezeigt.

Diese Eigenschaft steuert nur die Anzeige des Indikators. Sie müssen den untergeordneten Objekten einen Validator anfügen, wenn Sie eine Überprüfung der Eingaben verlangen.

Box Ein Halo Box-Container ordnet seine untergeordneten Objekte in einer einzigen vertikalen Spalte oder einer einzigen horizontalen Zeile. The <mx:Box> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Box
    Properties
    direction="vertical|horizontal"
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Box>
  

]]>
mx.core:Container Ein Halo Box-Container ordnet seine untergeordneten Objekte in einer einzigen vertikalen Spalte oder einer einzigen horizontalen Zeile. Die direction-Eigenschaft bestimmt, ob ein vertikales (Standardvorgabe) oder ein horizontales Layout verwendet wird.

Hinweis: Adobe empfiehlt, wenn immer möglich die Spark-Container mit HorizontalLayout oder VerticalLayout anstelle des Halo Box-Containers zu verwenden.

Die Box-Klasse ist die Basisklasse für die VBox- und HBox-Klassen. Sie verwenden die Tags <mx:Box>, <mx:VBox> und <mx:HBox> zur Definition der Box-Container.

Ein Box-Container weist folgende Merkmale für die Standardgrößen auf:

MerkmaleBeschreibung Standardgröße Vertical Box Die Höhe reicht aus, damit alle untergeordneten Objekte mit ihren Standardhöhenwerten oder expliziten Höhenwerten plus vertikale Lücken zwischen den untergeordneten Objekten plus oberer und unterer Füllbereich des Containers untergebracht werden können. Die Breite ist die Standardbreite oder explizite Breite des breitesten untergeordneten Objekts plus Auffüllbereich des Containers auf der linken und rechten Seite. Horizontal Box Die Breite reicht aus, damit alle untergeordneten Objekte mit ihren Standardbreitenwerten plus horizontale Lücken zwischen den untergeordneten Objekten plus linker und rechter Auffüllbereich des Containers untergebracht werden können. Die Höhe ist die Standardhöhe oder explizite Höhe des größten untergeordneten Objekts plus oberer und unterer Füllbereich des Containers. Standardwert für die Auffüllung 0 Pixel für oben, unten, links und rechts.
mx.components.Containermx.containers.HBoxmx.containers.VBoxBox Konstruktor. Konstruktor. measure Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte des Box-Containers. Berechnet die Standardgrößen und die Minimal- sowie Maximalwerte des Box-Containers.

Wenn die direction-Eigenschaft des Box-Containers auf BoxDirection.HORIZONTAL eingestellt ist, entspricht seine measuredWidth-Eigenschaft der Summe der Standardbreiten aller seiner untergeordneten Objekte, plus die Rahmenstärke, plus der linke und rechte Auffüllbereich, plus die horizontale Lücke zwischen den einzelnen untergeordneten Objekten. Der Wert der measuredHeight-Eigenschaft ist das Maximum aller Standardhöhen der untergeordneten Objekte, plus Raum für Rahmen und Auffüllung. Wenn die direction-Eigenschaft des Box-Containers auf BoxDirection.VERTICAL eingestellt ist, werden diese beiden Werte umgekehrt.

Die minWidth- und minHeight-Eigenschaften des Box-Containers werden ähnlich berechnet, indem die Mindestbreiten und Mindesthöhen der untergeordneten Objekte kombiniert werden. Wenn die width-Eigenschaft des untergeordneten Objekts ein Prozentwert ist, entspricht die Minimalbreite des Box-Containers dem Wert der minWidth-Eigenschaft des untergeordneten Objekts. Wenn die width-Eigenschaft des untergeordneten Objekts gelöscht oder auf einen festen Wert gesetzt ist, vergrößert oder verkleinert sich das untergeordnete Objekt nicht, daher ist die Mindestbreite des Box-Containers gleich dem Wert der explicitWidth-Eigenschaft des untergeordneten Objekts. Die Minimalhöhe des untergeordneten Objekts wird ähnlich berechnet.

Die maxWidth- und maxHeight-Eigenschaften des Box-Containers werden nicht berechnet. Die Maximalbreite und Maximalhöhe des Box-Containers wird als unbegrenzt angesehen.

Alle vorstehend beschriebenen Werte sind gemessene Breiten und Höhen des Box-Containers. Der Benutzer kann die gemessenen Werte überschreiben, indem er explizit einen Wert für die folgenden Eigenschaften festlegt:

  • width
  • height
  • minWidth
  • minHeight
  • maxWidth
  • maxHeight

Die measure()-Methode sollte nicht direkt aufgerufen werden. Der Flex-LayoutManager ruft sie zum erforderlichen Zeitpunkt auf. Beim Start der Anwendung versucht der Flex-LayoutManager, alle Komponenten - von den untergeordneten bis zu den übergeordneten Objekten - zu messen, bevor er sie auf ihre endgültigen Größen festlegt.

Dies ist eine erweiterte Methode für die Verwendung von Unterklassen. Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.measure()-Methode oder die measuredHeight- und measuredWidth-Eigenschaften aufrufen. Sie können optional auch die folgenden Eigenschaften festlegen:

  • measuredMinWidth
  • measuredMinHeight

Diese Eigenschaften entsprechen den weiter oben angeführten Layouteigenschaften und werden daher nicht eigens dokumentiert.

pixelsToPercent Die Methode zur Konvertierung von einer Anzahl von Pixeln in einen Prozentwert in Bezug auf den Inhalt dieses Containers.Der Prozentwert, der unter den aktuellen Layoutbedingungen dieses Containers gleich pxl sein würde. Ein negativer Wert zeigt an, dass der Container wachsen muss, um die angeforderte Größe unterbringen zu können. pxlDie Anzahl von Pixeln, für die ein Prozentwert gewünscht ist. Die Methode zur Konvertierung von einer Anzahl von Pixeln in einen Prozentwert in Bezug auf den Inhalt dieses Containers.

Der Prozentwert ist nur relevant, wenn der Container seine Größe oder sein Layout nicht ändert. Nach Eintritt einer Größenänderung und/oder einem neuen Layout kann der von dieser Methode zurückgegebene Wert veraltet sein.

Ein Beispiel für den Einsatz dieser Methode ist die Wiederherstellung der Größe einer Komponente auf eine bestimmte Pixelanzahl, nachdem sie verborgen wurde.

updateDisplayList Legt die Größe und Position jedes untergeordneten Objekts des Box-Containers fest.unscaledWidthLegt die Breite der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleX-Eigenschaft der Komponente. unscaledHeightLegt die Höhe der Komponente in Pixeln und deren Koordinaten fest, unabhängig vom Wert der scaleY-Eigenschaft der Komponente. Legt die Größe und Position jedes untergeordneten Objekts des Box-Containers fest.

Um den Layoutalgorithmus für den Box-Container zu verstehen, gehen Sie davon aus, dass die Richtung des Box-Containers horizontal ist.

Alle untergeordneten Objekte des Box-Containers werden nebeneinander in einer einzelnen horizontalen Reihe angeordnet, mit horizontalGap Pixeln zwischen jedem Paar nebeneinanderliegender untergeordneter Objekte. Zunächst werden die Breiten von untergeordneten Objekten ohne explizite Breitenwerte so eingestellt wie die Werte ihrer measuredWidth-Eigenschaften.

Wenn die Summe der Werte der measuredWidth-Eigenschaft der untergeordneten Objekte größer oder kleiner ist als die Breite des Box-Containers und wenn einige untergeordnete Objekte einen Prozentwert für die width-Eigenschaft haben, werden diese untergeordneten Objekte vergrößert oder verkleinert, bis alle untergeordneten Objekte in den Box-Container passen. Allerdings wird kein untergeordnetes Objekt auf weniger als den Wert minWidth-Eigenschaft verkleinert oder auf mehr als den Wert seiner maxWidth-Eigenschaft vergrößert. Zwischen den vergrößerten (oder verkleinerten) untergeordneten Objekten werden Zwischenräume im Verhältnis zu percentWidth des untergeordneten Objekts hinzugefügt (oder entfernt). Beispiel: Ein untergeordnetes Objekt mit einer percentWidth von 40 Prozent wächst doppelt so stark wie ein untergeordnetes Objekt mit einer percentWidth von 20 Prozent, bis der verfügbare Raum ausgefüllt ist oder die vorgeschriebenen Größen erreicht sind.

Nachdem alle flexiblen untergeordneten Objekte vergrößert oder verkleinert wurden, prüft Flex, ob die Summe der Breiten der untergeordneten Objekte zur Breite des Box-Containers passt. Wenn nicht, wird die Gruppe untergeordneter Objekte je nach dem Wert der horizontalAlign-Eigenschaft des Box-Containers verschoben, damit die untergeordneten Objekte am linken Rand des Box-Containers, dem rechten Rand des Box-Containers oder zentriert in der Mitte des Box-Containers ausgerichtet sind.

Um die Höhe jedes untergeordneten Objekts bestimmen zu können, prüft Flex den Wert der height-Eigenschaft des untergeordneten Objekts. Wenn die height gelöscht ist, wird die Höhe des untergeordneten Objekts auf measuredHeight eingestellt. Wenn height auf einen Pixelwert eingestellt ist, wird dieser Wert verwendet. Wenn height auf einen Prozentwert eingestellt ist, wird die Höhe des untergeordneten Objekts vergrößert oder verkleinert, um zum festgelegten Prozentwert des Box-Containers zu passen, wobei aber die Höhe des untergeordneten Objekts nicht auf weniger als den Wert seiner minHeight-Eigenschaft verkleinert oder auf mehr als den Wert seiner maxHeight-Eigenschaft vergrößert werden kann.

Die vertikale Position jedes untergeordneten Objekts wird durch die verticalAlign-Eigenschaft des Box-Containers bestimmt. Jedes untergeordnete Objekt wird so verschoben, dass es mit dem oberen Rand des Box-Containers, mit dem unteren Rand des Box-Containers oder in der Mitte des Box-Containers ausgerichtet ist.

Wenn die direction-Eigenschaft des Box-Containers vertical ist, gelten dieselben Regeln, nur werden die Breiten und Höhen vertauscht. Die untergeordneten Objekte werden in einer einzigen, vertikalen Spalte angeordnet.

Sie sollten diese Methode nicht direkt aufrufen. Der Flex-LayoutManager ruft sie zum erforderlichen Zeitpunkt auf. Wenn die Anwendung startet, ruft der Flex-LayoutManager die updateDisplayList()-Methode für jede Komponente auf, wobei mit dem Application-Objekt begonnen und ab da weiterverarbeitet wird.

Dies ist eine erweiterte Methode für die Verwendung von Unterklassen. Wenn Sie diese Methode überschreiben, muss Ihre Implementierung die super.updateDisplayList()-Methode und dann für jedes untergeordnete Objekt die move()- und setActualSize()-Methoden aufrufen. Für Layoutzwecke sollten Sie die Größe dieses Containers aus den unscaledWidth- und unscaledHeight-Eigenschaften abrufen und nicht aus den width- und height-Eigenschaften. Die width- und height-Eigenschaften berücksichtigen die Werte der scaleX- und scaleY-Eigenschaften für diesen Container nicht.

direction Die Richtung, in die dieser Box-Container seine untergeordneten Objekte auslegt.BoxDirection.VERTICAL Die Richtung, in die dieser Box-Container seine untergeordneten Objekte auslegt. Mögliche MXML-Werte sind „horizontal“ und „vertical“. Zulässige Werte in ActionScript sind BoxDirection.HORIZONTAL und BoxDirection.VERTICAL.