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

SmartGridLayout  - AS3 ADEP Composite Application

Paketcom.adobe.mosaic.layouts
Klassepublic class SmartGridLayout
VererbungSmartGridLayout Inheritance MosaicLayoutBase Inheritance LayoutBase Inheritance OnDemandEventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The SmartGridLayout places its target Group's children into a grid pattern, but with a twist. Most grid layout have uniform cells with the size of the cell either determined by the size of the largest child or by explicit row and column sizes.

The SmartGridLayout is different: it tries to maximimze the space in order to present as much of the child components as possible. If there is only one child, that child takes up 100% of the space, filling the area of the target Group. If there are two children, the SmartGrid divides the space in half, but gives each child 100% of the height. The children are separated into columns up to the maxNumColumns number of columns is reached.

Once the first row is filled out, the space is divided evenly amoung the children, shrinking the children in height, but maintaining the maxNumColumns number of columns. Once the child-height reaches minRowHeight the children stop shrinking and continue to fill the space vertically. If the target Group is contained within a Scroller, scrollbars should appear.

This layout does not support virtual layouts.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedanimationDuration : int
The amount of time to give any annimation to run its course.
MosaicLayoutBase
 InheritedclipAndEnableScrolling : Boolean
Mit „true“ wird angegeben, dass die untergeordneten Elemente auf die Begrenzungen des Viewports gekürzt werden.
LayoutBase
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheriteddropIndicator : DisplayObject
Das von diesem Layout für den Dropindikator bei Drag & Drop-Vorgängen verwendete DisplayObject.
LayoutBase
 InheritedeffectEndHandler : Function
The function used to handle EffectEvent events.
MosaicLayoutBase
 InheritedhorizontalGap : int
The spacing between the columns.
MosaicLayoutBase
 InheritedhorizontalScrollPosition : Number
Die x-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente.
LayoutBase
  maxNumColumns : int
The maximum number of columns the grid should display when orientation is set to "columns".
SmartGridLayout
  maxNumRows : int
The maximum number of rows the grid should display with orientation is set to "rows".
SmartGridLayout
  minColumnWidth : Number
The minimum size a column may become.
SmartGridLayout
  minRowHeight : Number
The minimum size a row may become.
SmartGridLayout
  orientation : String
The grid can be filled either column-wise (default) or row-wise.
SmartGridLayout
 InheritedpaddingBottom : int
The space between the container edge and the bottom row of items.
MosaicLayoutBase
 InheritedpaddingLeft : int
The space between the container edge and the left column of items.
MosaicLayoutBase
 InheritedpaddingRight : int
The space between the container edge and the right column of items.
MosaicLayoutBase
 InheritedpaddingTop : int
The space between the container edge and the top row of items.
MosaicLayoutBase
 Inheritedtarget : GroupBase
[override] Called when the target group is set for this layout.
MosaicLayoutBase
 InheritedtypicalLayoutElement : ILayoutElement
In Layouts verwendet, wenn feste Zeilen- bzw. Spaltengrößen angefordert sind, jedoch keine bestimmte Größe angegeben ist.
LayoutBase
 InheriteduseVirtualLayout : Boolean
Ein Container kann eine beliebige Anzahl an untergeordneten Objekten definieren.
LayoutBase
 InheritedverticalGap : int
The spacing between the rows.
MosaicLayoutBase
 InheritedverticalScrollPosition : Number
Die y-Koordinate im Ursprung des Viewports im Koordinatensystem der Komponente. Der Standardwert lautet (0,0) und entspricht der linken oberen Ecke der Komponente.
LayoutBase
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedeffectList : Parallel
A collection of effects to play in parallel.
MosaicLayoutBase
 InheritedelementBeingRemoved : int = -1
The index of the element being removed, referenced to generate the special effects to display the removal, and then reset to -1 (default).
MosaicLayoutBase
 InheritedlayoutUndefined : Boolean = true
Default is true.
MosaicLayoutBase
 Inheritedmaximized : Boolean = false
Default is false.
MosaicLayoutBase
 InheritedmaximizedElement : IVisualElement
The IVisualElement being maximized.
MosaicLayoutBase
 InheritedmeasuredMaxHeight : Number
The measured maximum height of an element.
MosaicLayoutBase
 InheritedmeasuredMaxWidth : Number
The measured maximum width of an element.
MosaicLayoutBase
 InheritedminimizedElements : Array
The Array of IVisualElement elements currently minimized.
MosaicLayoutBase
 InheritedrestoreCellHeight : Number
The height to restore a minimized element to.
MosaicLayoutBase
 InheritedrestoreCellWidth : Number
The width to restore a minimized element to.
MosaicLayoutBase
Öffentliche Methoden
 MethodeDefiniert von
  
Constructor
SmartGridLayout
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
OnDemandEventDispatcher
  
[override] Determines the location of the drop (should it happen) and returns that information in the form of a DropLocation.
SmartGridLayout
 Inherited
Ist useVirtualLayout „true“, kann diese Methode vom Layoutziel verwendet werden, um zwischengespeicherte Layoutinformationen zu löschen, wenn sich das Ziel ändert.
LayoutBase
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
OnDemandEventDispatcher
 Inherited
[override] Called whenever an element is added to the target.
MosaicLayoutBase
 Inherited
[override] Called whenever an element is removed.
MosaicLayoutBase
 Inherited
Gibt die Layoutgrenzen des angegebenen Elements als Rechteck zurück oder null, wenn die Indexposition ungültig, das entsprechende Element null, includeInLayout=false oder die Zieleigenschaft des Layouts null ist.
LayoutBase
 Inherited
Gibt die Änderung der horizontalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten.
LayoutBase
 Inherited
Returns the ILayoutChild that occupies the given display list index.
MosaicLayoutBase
 Inherited
getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Delegationsmethode, die auf Grundlage des aktuellen Elements im Fokus und der Benutzereingabe hinsichtlich der NavigationUnit bestimmt, zu welchem Element zu navigieren ist.
LayoutBase
 Inherited
Berechnet das verticalScrollPosition- und das horizontalScrollPosition-Delta, die benötigt werden, um einen Bildlauf des Elements an der angegebenen Indexposition in die Ansicht durchzuführen.
LayoutBase
 Inherited
Gibt die Änderung der vertikalen Bildlaufposition zurück, um verschiedene Bildlaufoptionen zu verarbeiten.
LayoutBase
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
OnDemandEventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Blendet den zuvor angezeigten Dropindikator, der durch die showDropIndicator()-Methode erstellt wurde, aus und entfernt ihn aus der Anzeigeliste. Beendet außerdem den Ziehbildlauf.
LayoutBase
 Inherited
When a value of true is return, this layout is currently showing a maximized child element.
MosaicLayoutBase
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Maximizes the given element to take up entire target space (minus padding, of course).
MosaicLayoutBase
  
[override] Called when the target requires measurement.
SmartGridLayout
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
OnDemandEventDispatcher
 Inherited
Restores an element that has been maximized.
MosaicLayoutBase
 Inherited
Handles the layout side of restoring a previously minimized element by making it appear.
MosaicLayoutBase
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Platziert den Dropindikator und verändert dessen Größe anhand der angegebenen Ablageposition und ist sein übergeordnetes Element.
LayoutBase
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Platziert die Elemente des Ziels und ändert deren Größe.
LayoutBase
 Inherited
Wird vom Ziel am Ende der updateDisplayList()-Methode aufgerufen, damit das Layout das scrollRect aktualisiert.
LayoutBase
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Handles the layout side of a minimized element by making it disappear.
MosaicLayoutBase
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
OnDemandEventDispatcher
Geschützte Methoden
 MethodeDefiniert von
 Inherited
Berechnet die Länge des erforderlichen Bildlaufs für die angegebene dropLocation während eines Drag & Drop-Vorgangs.
LayoutBase
 Inherited
[override] Locates the item under the point using a simple look-up, accounting for horizontal and vertical gaps.
MosaicLayoutBase
  
[override] Determines the size and position of the drop indicator, returning an Rectangle with the proper boundaries.
SmartGridLayout
  
calculateLayoutPositions(width:Number, height:Number, updateInPlace:Boolean, returnArray:Boolean):Array
[override] Sizes and positions the target's elements in the normal fashion for this layout.
SmartGridLayout
  
Called to calculate key variables.
SmartGridLayout
 Inherited
Generates a series of Move and Resize effects for item being placing them into their new positions.
MosaicLayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die obere Kante des scrollRect erstreckt oder sich darüber befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die untere Kante des scrollRect erstreckt oder sich darunter befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die linke Kante des scrollRect erstreckt oder sich links davon befindet.
LayoutBase
 Inherited
Gibt die Grenzen des ersten Layoutelements zurück, das sich entweder über die rechte Kante des scrollRect erstreckt oder sich rechts davon befindet.
LayoutBase
 Inherited
Gibt die Grenzen des Bildlaufrechtecks des Ziels in Layoutkoordinaten zurück.
LayoutBase
 Inherited
Sizes and positions the maximized element.
MosaicLayoutBase
 Inherited
The layout to use when operating in a non-maximized mode.
MosaicLayoutBase
  
Returns the number of elements that can be seen.
SmartGridLayout
 Inherited
Called when the effects are over to reset the elementBeingMoved value.
MosaicLayoutBase
 Inherited
Wird aufgerufen, wenn sich die verticalScrollPosition- oder horizontalScrollPosition-Eigenschaft ändert.
LayoutBase
Eigenschaftendetails

maxNumColumns

Eigenschaft
maxNumColumns:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The maximum number of columns the grid should display when orientation is set to "columns". The grid may show less columns but never any more than this number.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get maxNumColumns():int
    public function set maxNumColumns(value:int):void

maxNumRows

Eigenschaft 
maxNumRows:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The maximum number of rows the grid should display with orientation is set to "rows". The grid may show less rows but never more than this number.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get maxNumRows():int
    public function set maxNumRows(value:int):void

minColumnWidth

Eigenschaft 
minColumnWidth:Number

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The minimum size a column may become. Adding more items to the target may shrink the item but never less than this amount. The target may acquire scrollbars if the item will not fit in the target's visible space. This property applies only when orientation is set to "rows".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get minColumnWidth():Number
    public function set minColumnWidth(value:Number):void

minRowHeight

Eigenschaft 
minRowHeight:Number

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The minimum size a row may become. Adding more items to the target may shrink the item but never less than this amount. The target may acquire scrollbars if the item will not fit in the target's visible space. This property applies only when orientation is set to "columns".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get minRowHeight():Number
    public function set minRowHeight(value:Number):void

orientation

Eigenschaft 
orientation:String

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

The grid can be filled either column-wise (default) or row-wise. When the grid is being filled column-wise, the items flow from left to right, top to bottom. When the grid is filled row-wise, the items flow from top to bottom, left to right.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get orientation():String
    public function set orientation(value:String):void
Konstruktordetails

SmartGridLayout

()Konstruktor
public function SmartGridLayout()

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Constructor

Methodendetails

calculateDropIndicatorBounds

()Methode
override protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Determines the size and position of the drop indicator, returning an Rectangle with the proper boundaries. The dropLocation always points to the item being moved, so the indicator is almost always drawn to its left (column orientation) or top (row orientation). If the location points to the last item (the index is equal to the number of items in the target), then the indicator is drawn to its right (column) or bottom (row).

Parameter

dropLocation:DropLocation — The position within the layout where the drop can be expected.

Rückgabewerte
Rectangle — A rectangle the describes the area of the drop.

calculateDropLocation

()Methode 
override public function calculateDropLocation(dragEvent:DragEvent):DropLocation

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Determines the location of the drop (should it happen) and returns that information in the form of a DropLocation. However, since this layout is row,column based and index may not be meaningful, the object returned is an instance of MosaicDropLocation that contains row and column index information.

Parameter

dragEvent:DragEvent — The event that contains the position of the mouse.

Rückgabewerte
DropLocation — The location where the drop could happen.

calculateLayoutPositions

()Methode 
override protected function calculateLayoutPositions(width:Number, height:Number, updateInPlace:Boolean, returnArray:Boolean):Array

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Sizes and positions the target's elements in the normal fashion for this layout.

Parameter

width:Number — The width of the target Group's area.
 
height:Number — The height of the target Group's area.
 
updateInPlace:Boolean — If true, the children are changed, if false, they are left as-is.
 
returnArray:Boolean — If true, an array of row and column positions is returned.

Rückgabewerte
Array — An array of row and column positions for each child or an empty array if returnArray is false.

calculateSizes

()Methode 
protected function calculateSizes():void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Called to calculate key variables.

measure

()Methode 
override public function measure():void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Called when the target requires measurement.

numValidElements

()Methode 
protected function numValidElements():int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Laufzeitversionen: AIR 2.6, Flash Player 10.2

Returns the number of elements that can be seen.

Rückgabewerte
int — Number of elements that can be seen.




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

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