VerticalLayout

パッケージ	spark.layouts
クラス	public class VerticalLayout
継承	VerticalLayout LayoutBase OnDemandEventDispatcher Object
サブクラス	FormLayout

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

VerticalLayout クラスは、レイアウトエレメントを垂直方向に上から下の順序で配置します。必要な場合は、各エレメント間の間隔および一連のエレメントの周囲にパディングを設定できます。

エレメントの垂直位置は、最初のエレメントの前のパディングと各エレメント間の間隔を考慮して、垂直方向に上から下の順序でエレメントを配置することにより決定されます。

エレメントの水平位置は、レイアウトの horizontalAlign プロパティによって決定されます。

measure() メソッドの実行中に、コンテナのデフォルトサイズは、エレメントの推奨サイズ（間隔とパディングを含む）を収集することにより計算されます。requestedRowCount を設定すると、最初のエレメントから始めて、指定した数のエレメントのスペースのみが測定されます。

updateDisplayList() メソッドの実行中に、各エレメントの高さは、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小高さと最大高さは、必ず順守されます）。

variableRowHeight が false の場合は、エレメントの高さを rowHeight プロパティの値に設定します。
エレメントの percentHeight が設定されている場合は、percentHeight 設定を使用して、使用可能なコンテナの高さをすべてのエレメント間で分配し、エレメントの高さを計算します。使用可能なコンテナの高さは、間隔、パディング、および残りのエレメントが占有しているスペースをコンテナの高さから引いた値に等しくなります。レイアウトが仮想化されている場合は、エレメントの precentHeight プロパティが無視されます。
エレメントの高さにその推奨高さを設定します。

各エレメントの幅は、次のルールに従って計算されます。これらの各ルールは、優先順にリストされています（エレメントの最小幅と最大幅は、必ず順守されます）。

horizontalAlign が「justify」の場合は、エレメントの幅をコンテナの幅に設定します。
horizontalAlign が「contentJustify」の場合は、コンテナの幅とすべてのエレメントの推奨幅の間の最大値をエレメントの幅に設定します。
エレメントの percentWidth が設定されている場合は、エレメントの幅をコンテナの幅に対する割合として計算します。
エレメントの幅にその推奨幅を設定します。

MXML シンタックス expanded

MXML シンタックスを隠す

The <s:VerticalLayout> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:VerticalLayout 
    Properties
    gap="6"
    horizontalAlign="left"
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    requestedMaxRowCount="-1"
    requestedMinRowCount="-1"
    requestedRowCount="-1"
    rowHeight="calculated"
    variableRowHeight="true"
    verticalAlign="top"
  />

さらに例を参照

About Spark layouts
Setting the layout of a Spark container
Setting the padding and gap of a layout
Setting the alignment of a layout
Setting the row height or column width of a layout

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		clipAndEnableScrolling : Boolean true の場合、ビューポートの境界に子をクリッピングするように指定します。	LayoutBase
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		dropIndicator : DisplayObject このレイアウトがドラッグ＆ドロップ操作の間にドロップインジケーターに対して使用する DisplayObject です。	LayoutBase
		firstIndexInView : int [読み取り専用] レイアウトの一部であり、レイアウトターゲットのスクロール矩形内にある最初のレイアウトエレメントのインデックスです。まだ何も表示されていない場合は -1 です。	VerticalLayout
		gap : int レイアウトエレメント間の垂直方向の間隔（ピクセル単位）です。	VerticalLayout
		horizontalAlign : String レイアウトエレメントの水平方向の配置です。	VerticalLayout
		horizontalScrollPosition : Number コンポーネントの座標系における、ビューポートの原点の x 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。	LayoutBase
		lastIndexInView : int [読み取り専用] レイアウトの一部であり、コンテナのスクロール矩形内にある最後の行のインデックスです。まだ何も表示されていない場合は -1 です。	VerticalLayout
		paddingBottom : Number コンテナの下端と最後のレイアウトエレメントの下端との間にあるピクセルの数です。	VerticalLayout
		paddingLeft : Number コンテナの左端とレイアウトエレメントの左端との間にあるピクセルの最少数です。	VerticalLayout
		paddingRight : Number コンテナの右端とレイアウトエレメントの右端との間にあるピクセルの最少数です。	VerticalLayout
		paddingTop : Number コンテナの上端と最初のレイアウトエレメントの上端との間にあるピクセルの数です。	VerticalLayout
		requestedMaxRowCount : int このレイアウトの測定された高さは、少なくとも requestedMaxRowCount レイアウトエレメントを表示できるだけの高さになります。	VerticalLayout
		requestedMinRowCount : int このレイアウトの測定された高さは、少なくとも requestedMinRowCount レイアウトエレメントを表示できるだけの高さになります。	VerticalLayout
		requestedRowCount : int このレイアウトの測定サイズは、最初の requestedRowCount レイアウトエレメントを表示するのに十分な高さです。	VerticalLayout
		rowCount : int [読み取り専用] 現在表示されているエレメントの数です。	VerticalLayout
		rowHeight : Number variableRowHeight が false の場合、このプロパティは、それぞれの子の実際の高さ（ピクセル単位）を指定します。	VerticalLayout
		target : GroupBase このレイアウトによってエレメントが測定され、そのサイズと位置が設定される GroupBase コンテナです。	LayoutBase
		typicalLayoutElement : ILayoutElement 固定の行 / 列サイズが要求されたときに、特定のサイズが指定されていない場合、レイアウトによって使用されます。	LayoutBase
		useVirtualLayout : Boolean 1 つのコンテナには任意の数の子を追加できます。	LayoutBase
		variableRowHeight : Boolean レイアウトエレメントに推奨高さを割り当てるかどうかを示します。	VerticalLayout
		verticalAlign : String コンテナの高さを基準にしたコンテンツの垂直方向の配置です。	VerticalLayout
		verticalScrollPosition : Number コンポーネントの座標系における、ビューポートの原点の y 座標です。デフォルト値は (0,0) であり、これはコンポーネントの左上隅に対応します。	LayoutBase

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		VerticalLayout() コンストラクターです。	VerticalLayout
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	OnDemandEventDispatcher
		calculateDropLocation(dragEvent:DragEvent):DropLocation 指定した dragEvent に対するドロップターゲットのデータプロバイダー内でのドロップ位置を計算します。	LayoutBase
		clearVirtualLayoutCache():void useVirtualLayout が true の場合、レイアウトターゲットが変化するときにターゲットでこのメソッドを使用すると、キャッシュされているレイアウト情報をクリアできます。	LayoutBase
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	OnDemandEventDispatcher
		elementAdded(index:int):void レイアウトエレメントが追加されてからターゲットのサイズと表示リストが検証されるまでの間に、ターゲットで呼び出されます。	LayoutBase
		elementRemoved(index:int):void このメソッドは、レイアウトエレメントが削除されてからターゲットのサイズと表示リストが検証されるまでの間に、ターゲットで呼び出されます。	LayoutBase
		fractionOfElementInView(index:int):Number 指定したインデックスが完全に表示されている場合は 1.0、表示されていない場合は 0.0、部分的に表示されている場合はその割合を表す 0.0 ～ 1.0 の範囲の値を返します。	VerticalLayout
		getElementBounds(index:int):Rectangle 指定されたエレメントのレイアウト境界を矩形として返します。インデックスが無効の場合、対応するエレメントが null の場合、includeInLayout=false の場合、またはこのレイアウトの target プロパティが null の場合は、null を返します。	LayoutBase
		getHorizontalScrollPositionDelta(navigationUnit:uint):Number 異なるスクロールオプションを処理するために、水平スクロール位置に対する変更を返します。	LayoutBase
		getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int フォーカスを持っている現在のアイテムと NavigationUnit に関するユーザー入力に基づいてナビゲート先のアイテムを決定する委譲メソッドです。	LayoutBase
		getScrollPositionDeltaToElement(index:int):Point 指定したインデックスにあるエレメントをビュー内にスクロールするために必要な verticalScrollPosition デルタと horizontalScrollPosition デルタを計算します。	LayoutBase
		getVerticalScrollPositionDelta(navigationUnit:uint):Number 異なるスクロールオプションを処理するために、垂直スクロール位置に対する変更を返します。	LayoutBase
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		hideDropIndicator():void showDropIndicator() メソッドによって作成されて、以前に表示したドロップインジケーターを非表示にし、表示リストから削除して、ドラッグスクロールも停止します。	LayoutBase
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		measure():void ターゲットのデフォルトサイズをそのコンテンツに基づいて測定します。また、必要に応じて、ターゲットのデフォルト最小サイズを測定します。	LayoutBase
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		showDropIndicator(dropLocation:DropLocation):void 指定したドロップ位置に基づいて、ドロップインジケーターのサイズ、位置、親を設定します。	LayoutBase
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		updateDisplayList(width:Number, height:Number):void ターゲットのエレメントのサイズと位置を設定します。	LayoutBase
		updateScrollRect(w:Number, h:Number):void レイアウトで scrollRect を更新するために、updateDisplayList の最後にターゲットによって呼び出されます。	LayoutBase
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	OnDemandEventDispatcher

プロテクトメソッド

継承されるプロテクトメソッドを隠す

継承されるプロテクトメソッドを表示

	メソッド		定義元
		calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point ドラッグ＆ドロップ動作中の指定された dropLocation までのスクロール距離を計算します。	LayoutBase
		calculateDropIndex(x:Number, y:Number):int ドラッグ＆ドロップ動作中にユーザーが指定された座標でマウスを離した場合に、新しいアイテムを挿入するインデックスを返します。	LayoutBase
		calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle ドラッグ＆ドロップ動作の終了時にアイテムが挿入される位置をユーザーに対して視覚的にフィードバックするドロップインジケーターの境界を計算します。	LayoutBase
		getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle scrollRect の上端にまたがっているか、その上にある最初のレイアウトエレメントの境界を返します。	LayoutBase
		getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle scrollRect の下端にまたがっているか、その下にある最初のレイアウトエレメントの境界を返します。	LayoutBase
		getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle scrollRect の左端にまたがっているか、その左にある最初のレイアウトエレメントの境界を返します。	LayoutBase
		getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle scrollRect の右端にまたがっているか、その右にある最初のレイアウトエレメントの境界を返します。	LayoutBase
		getScrollRect():Rectangle レイアウト座標のターゲットのスクロール矩形の境界を返します。	LayoutBase
		scrollPositionChanged():void verticalScrollPosition プロパティまたは horizontalScrollPosition プロパティの変更時に呼び出されます。	LayoutBase

プロパティの詳細

firstIndexInView

プロパティ

firstIndexInView:int [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

レイアウトの一部であり、レイアウトターゲットのスクロール矩形内にある最初のレイアウトエレメントのインデックスです。まだ何も表示されていない場合は -1 です。

「レイアウトの一部」とは、エレメントが null 以外であり、その includeInLayout プロパティが true であることを意味します。

レイアウトエレメントは部分的にビューに含まれているだけの場合があることに注意してください。

このプロパティはデータバインディングのソースとして使用できます。このプロパティを変更すると、 indexInViewChanged イベントが送出されます。

実装
public function get firstIndexInView():int

関連する API エレメント

fractionOfElementInView()

gap

プロパティ

gap:int

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

レイアウトエレメント間の垂直方向の間隔（ピクセル単位）です。この間隔はレイアウトエレメント間にのみ適用されることに注意してください。そのため、エレメントが 1 つしかないと、この間隔はレイアウトに影響を与えません。

デフォルト値： 6。

実装
public function get gap():int
public function set gap(value:int):void

horizontalAlign

プロパティ

horizontalAlign:String

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

レイアウトエレメントの水平方向の配置です。値が「left」、「right」、または「center」の場合、レイアウトエレメントはコンテナの contentWidth プロパティを基準にして配置されます。

値が「contentJustify」の場合、レイアウトエレメントの実際の幅はコンテナの contentWidth に設定されます。コンテナの contentWidth は、最も大きいレイアウトエレメントの幅です。すべてのレイアウトエレメントがコンテナの幅より小さい場合は、すべてのレイアウトエレメントの幅をコンテナの幅に設定します。

値が「justify」の場合、レイアウトエレメントの実際の幅は、コンテナの幅に設定されます。

このプロパティは、レイアウトの測定サイズに影響を及ぼしません。

デフォルト値： "left"。

実装
public function get horizontalAlign():String
public function set horizontalAlign(value:String):void

lastIndexInView

プロパティ

lastIndexInView:int [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

レイアウトの一部であり、コンテナのスクロール矩形内にある最後の行のインデックスです。まだ何も表示されていない場合は -1 です。

「レイアウトの一部」とは、子が null 以外であり、その includeInLayout プロパティが true であることを意味します。

行は部分的にビューに含まれているだけの場合があることに注意してください。

このプロパティはデータバインディングのソースとして使用できます。このプロパティを変更すると、 indexInViewChanged イベントが送出されます。

実装
public function get lastIndexInView():int

関連する API エレメント

firstIndexInView
fractionOfElementInView

paddingBottom

プロパティ

paddingBottom:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンテナの下端と最後のレイアウトエレメントの下端との間にあるピクセルの数です。

デフォルト値： 0。

実装
public function get paddingBottom():Number
public function set paddingBottom(value:Number):void

paddingLeft

プロパティ

paddingLeft:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンテナの左端とレイアウトエレメントの左端との間にあるピクセルの最少数です。

デフォルト値： 0。

実装
public function get paddingLeft():Number
public function set paddingLeft(value:Number):void

paddingRight

プロパティ

paddingRight:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンテナの右端とレイアウトエレメントの右端との間にあるピクセルの最少数です。

デフォルト値： 0。

実装
public function get paddingRight():Number
public function set paddingRight(value:Number):void

paddingTop

プロパティ

paddingTop:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンテナの上端と最初のレイアウトエレメントの上端との間にあるピクセルの数です。

デフォルト値： 0。

実装
public function get paddingTop():Number
public function set paddingTop(value:Number):void

requestedMaxRowCount

プロパティ

requestedMaxRowCount:int

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4.5

ランタイムバージョン:

Flash Player 10, AIR 2.5

このレイアウトの測定された高さは、少なくとも requestedMaxRowCount レイアウトエレメントを表示できるだけの高さになります。

requestedRowCount が設定されている場合、このプロパティは無視されます。

コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。

デフォルト値： -1。

実装
public function get requestedMaxRowCount():int
public function set requestedMaxRowCount(value:int):void

関連する API エレメント

requestedRowCount
requestedMinRowCount

requestedMinRowCount

プロパティ

requestedMinRowCount:int

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4.5

ランタイムバージョン:

Flash Player 10, AIR 2.5

このレイアウトの測定された高さは、少なくとも requestedMinRowCount レイアウトエレメントを表示できるだけの高さになります。

requestedRowCount が設定されている場合、このプロパティは無視されます。

コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。

デフォルト値： -1。

実装
public function get requestedMinRowCount():int
public function set requestedMinRowCount(value:int):void

関連する API エレメント

requestedRowCount
requestedMaxRowCount

requestedRowCount

プロパティ

requestedRowCount:int

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

このレイアウトの測定サイズは、最初の requestedRowCount レイアウトエレメントを表示するのに十分な高さです。

requestedRowCount が -1 の場合、測定サイズは、すべてのレイアウトエレメントに対して十分な大きさになります。

コンテナの実際のサイズが明示的に設定されている場合、このプロパティは無視されます。

デフォルト値： -1。

実装
public function get requestedRowCount():int
public function set requestedRowCount(value:int):void

rowCount

プロパティ

rowCount:int [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

現在表示されているエレメントの数です。

デフォルト値： -1。

このプロパティはデータバインディングのソースとして使用できます。このプロパティを変更すると、 propertyChange イベントが送出されます。

実装
public function get rowCount():int

rowHeight

プロパティ

rowHeight:Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

variableRowHeight が false の場合、このプロパティは、それぞれの子の実際の高さ（ピクセル単位）を指定します。

variableRowHeight が true（デフォルト）の場合、このプロパティは無視されます。

このプロパティのデフォルト値は、typicalLayoutElement の推奨高さです。

実装
public function get rowHeight():Number
public function set rowHeight(value:Number):void

variableRowHeight

プロパティ

variableRowHeight:Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

レイアウトエレメントに推奨高さを割り当てるかどうかを示します。このプロパティを false に設定すると、行の高さが固定されます。

false の場合、各レイアウトエレメントの実際の高さは、rowHeight の値になります。このプロパティを false に設定すると、レイアウトエレメントの percentHeight プロパティがレイアウトで無視されます。

デフォルト値： true。

実装
public function get variableRowHeight():Boolean
public function set variableRowHeight(value:Boolean):void

verticalAlign

プロパティ

verticalAlign:String

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンテナの高さを基準にしたコンテンツの垂直方向の配置です。

値が「bottom」、「middle」、または「top」の場合、レイアウトエレメントはコンテナの contentHeight プロパティを基準にして配置されます。

clipAndEnableScrolling が true であり、contentHeight がコンテナの高さより大きい場合、このプロパティは無視されます。

このプロパティは、レイアウトの測定サイズに影響を及ぼしません。

デフォルト値： "top"。

実装
public function get verticalAlign():String
public function set verticalAlign(value:String):void

コンストラクターの詳細

()

コンストラクター

public function VerticalLayout()

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

コンストラクターです。

メソッドの詳細

fractionOfElementInView

()

メソッド

public function fractionOfElementInView(index:int):Number

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 4

ランタイムバージョン:

Flash Player 10, AIR 1.5

指定したインデックスが完全に表示されている場合は 1.0、表示されていない場合は 0.0、部分的に表示されている場合はその割合を表す 0.0 ～ 1.0 の範囲の値を返します。

対応する null 以外のレイアウトエレメントがコンテナの scrollRect の垂直方向の制限内にあり、レイアウトに含まれている場合、インデックスは「ビュー内」にあります。

指定したインデックスが部分的にビュー内に存在する場合、戻り値は、表示可能な対応するレイアウトエレメントに対する割合になります。

パラメーター

index:int — 行のインデックスです。

戻り値

Number — ビュー内にある指定したエレメントの割合です。指定したインデックスが無効の場合、または指定したインデックスが null エレメント、または includeInLayout プロパティが false である ILayoutElement に対応している場合は、0.0 を返します。

法律上の注意 | プライバシーポリシー

VerticalLayout - AS3 Flex

パッケージx

言語エレメント

付録

パッケージ spark.layouts

firstIndexInView

gap

horizontalAlign

lastIndexInView

paddingBottom

paddingLeft

paddingRight

paddingTop

requestedMaxRowCount

requestedMinRowCount

requestedRowCount

rowCount

rowHeight

variableRowHeight

verticalAlign

VerticalLayout

fractionOfElementInView