メソッド | プロパティ | エフェクト | イベント | スタイル | 例 フレームあり | フレームなし

mx.containers
DividedBox クラス

継承を示す線継承を示す線継承を示す線継承を示す線継承を示す線
直接の既知のサブクラス
           mx.containers.HDividedBox、mx.containers.VDividedBox

DividedBox クラス
mx.containers.Box の拡張

DividedBox クラスは、より一般的に使用される HDividedBox クラスおよび VDividedBox クラスの基本クラスです。これは Box クラスの拡張です。

DividedBox コンテナの子が水平方向または垂直方向に測定されて配置される方法は、ドラッグ可能な仕切りが子同士の隙間に挿入される点を除き、Box コンテナの場合とまったく同一です。ユーザーは、任意の側の仕切りをドラッグして子のサイズを変更できます。

DividedBox の direction プロパティ (Box から継承) は、レイアウトの方向を水平にするか垂直にするかを決定します。

MXML シンタックス

<mx:DividedBox> タグは、<mx:Box> タグのプロパティ、スタイル、およびイベントを継承し、次のものを追加します。

 <mx:DividedBox
   liveDragging="false|true"
   dividerAffordance="value"
   dividerColor="value"
   dividerThickness="value"
   dividerPressed="event handler"
   dividerDragged="event handler"
   dividerReleased="event handler"
   >
     ...
     child tags
     ...
 </mx:DividedBox>

例を参照するにはここをクリックしてください

メソッド
       getDividerAt( i:Number) :  mx.containers.dividedboxclasses.BoxDivider
 この DividedBox コンテナ内にある指定された BoxDivider オブジェクトへの参照を返します。
       getDividerCount( ) :  Number
 仕切りの数です。
       measure( ) :  Void
 Box の measure メソッドをオーバーライドします。
       moveDivider( i:Number, amt:Number) :  Number
 特定の仕切りを、指定されたピクセル数移動します。
       preLayoutAdjustment( )
アルゴリズムではあらかじめ用意されたレイアウトが採用され、空き領域が残らないように、また、明示的な最小値または最大値のみが使用されるようにします。

mx.containers.Box クラスから継承されるメソッド
layoutChildren   measure   pixelsToPercent   setRelativeChildHeights   setRelativeChildWidths  

mx.containers.Container クラスから継承されるメソッド
createChildren   draw   executeChildBindings   getViewMetrics   getViewMetricsAndMargins   init  

mx.core.View クラスから継承されるメソッド
childLoaded   constructObject2   createChild   createChildren   destroyAllChildren   destroyChild   destroyChildAt   draw   getBorderMetrics   getChildAt   getChildIndex   getViewMetrics   init   layoutChildren   layoutChrome   setChildIndex  

mx.core.UIComponent クラスから継承されるメソッド
drawFocus   getFocus   getFocusManager   setEnabled   setFocus  

mx.core.UIObject クラスから継承されるメソッド
addEventListener   applyProperties   buildDepthTable   commitProperties   constructObject2   createAccessibilityImplementation   createChildAtDepth   createChildren   createClassChildAtDepth   createClassObject   createEmptyObject   destroyObject   dispatchEvent   doLater   draw   drawRect   executeBindings   fillRect   findNextAvailableDepth   getRepeaterItem   getStyle   handleEvent   init   invalidate   invalidateLayout   invalidateProperties   invalidateSize   invalidateStyle   layoutChildren   measure   move   redraw   removeEventListener   setDepthAbove   setDepthBelow   setMask   setSize   setSizeNoLayout   setStyle   swapDepths  



プロパティ
       liveDragging:Boolean
true の場合、ユーザーが仕切りをドラッグしている間、その仕切りに隣接する子のサイズが連続的に変化します。

mx.containers.Box クラスから継承されるプロパティ
direction  

mx.containers.Container クラスから継承されるプロパティ
autoLayout   childDescriptors   className   clipContent   creationIndex   creationPolicy   defaultButton   hLineScrollSize   hPageScrollSize   hPosition   hScrollPolicy   icon   label   maxHPosition   maxVPosition   numRepeaters   version   vLineScrollSize   vPageScrollSize   vPosition   vScrollPolicy  

mx.core.View クラスから継承されるプロパティ
baselinePosition   className   numChildren   version  

mx.core.UIComponent クラスから継承されるプロパティ
enabled   errorString   tabEnabled   tabIndex   version  

mx.core.UIObject クラスから継承されるプロパティ
alpha   baselinePosition   className   depth   documentDescriptor   height   heightFlex   id   instanceIndices   isDocument   kStretch   layoutHeight   layoutWidth   maxHeight   maxWidth   minHeight   minWidth   mouseX   mouseY   nestLevel   oldHeight   oldWidth   oldX   oldY   parent   parentApplication   parentDocument   percentHeight   percentWidth   preferredHeight   preferredWidth   repeaterIndices   scaleX   scaleY   styleName   tabEnabled   toolTip   version   visible   width   widthFlex   x   y  



エフェクト

mx.core.UIComponent クラスから継承されるエフェクト
focusInEffect   focusOutEffect  

mx.core.UIObject クラスから継承されるエフェクト
creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect  



イベント
dividerDraggedユーザーが仕切りをドラッグしている間、dividerPressed イベントの後と dividerReleasedイベントの前に、複数回ブロードキャストします。このイベントオブジェクトの target プロパティは、イベントをブロードキャストするオブジェクト、つまりこのコンテナへの参照です。type プロパティは、イベントのタイプである dividerDragged です。dividerIndex プロパティは、ドラッグされている仕切りのゼロベースのインデックスです。最も左または上にある仕切りの dividerIndex は 0 です。その delta プロパティは、仕切りがドラッグしたピクセル数です。正の値は右または下へのドラッグを表し、負の値は左または上へのドラッグを表します。
dividerPressedユーザーがこのコンテナの仕切りを押したとき、dividerDraggedイベントがブロードキャストされる前にブロードキャストします。このイベントオブジェクトの target プロパティは、イベントをブロードキャストするオブジェクト、つまりこのコンテナへの参照です。type プロパティは、イベントのタイプである dividerPressed です。dividerIndex プロパティは、押された仕切りのゼロベースのインデックスです。一番左または一番上の仕切りの dividerIndex は 0 です。
dividerReleasedユーザーが仕切りを解放したとき、dividerDragged イベントの後、このコンテナのサイズが変更される前にブロードキャストします。このイベントオブジェクトの target プロパティは、イベントをブロードキャストするオブジェクト、つまりこのコンテナへの参照です。type プロパティは、イベントのタイプである dividerReleased です。dividerIndex プロパティは、解放された仕切りのゼロベースのインデックスです。最も左または上にある仕切りの dividerIndex は 0 です。その delta プロパティは、仕切りがドラッグしたピクセル数です。正の値は右または下へのドラッグを表し、負の値は左または上へのドラッグを表します。

mx.containers.Container クラスから継承されるイベント
childrenCreated  scroll 

mx.core.View クラスから継承されるイベント
childCreated  childDestroyed  childIndexChanged 

mx.core.UIComponent クラスから継承されるイベント
focusIn  focusOut  invalid  keyDown  keyUp  valid  valueCommitted 

mx.core.UIObject クラスから継承されるイベント
creationComplete  dragComplete  dragDrop  dragEnter  dragExit  dragOver  draw  effectEnd  effectStart  hide  hideToolTip  initialize  load  mouseChangeSomewhere  mouseDown  mouseDownSomewhere  mouseMove  mouseMoveSomewhere  mouseOut  mouseOver  mouseUp  mouseUpSomewhere  move  resize  show  showToolTip  unload 



スタイル
dividerAffordance 型 : Number   形式 : Length   CSS の継承 : なし
ユーザーが仕切りをドラッグできる領域の幅 (ピクセル単位)。この領域は、horizontalGap または verticalGap スタイルプロパティによって決定される、コンテナの子同士の隙間の中心に配置されます。このアフォーダンスは、隙間より大きなサイズには設定できません。マウスがこの領域にあるときは、サイズ変更カーソルが表示されます。デフォルト値は 6 です。
dividerColor 型 : Number   形式 : Color   CSS の継承 : あり
仕切りが押されているとき、またはドラッグされているときの色 (liveDragging が false の場合)。liveDragging が true の場合は、仕切りのつまみのみが表示されます。デフォルト値は 0x6F7777 です。
dividerThickness 型 : Number   形式 : Length   CSS の継承 : なし
仕切りが押されているとき、またはドラッグされているときの幅 (ピクセル単位、liveDragging が false の場合)。liveDragging が true の場合は、仕切りのつまみのみが表示されます。この視覚的な幅は、アフォーダンスより大きなサイズには設定できません。デフォルト値は 3 です。

mx.containers.Box クラスから継承されるスタイル
horizontalAlign   horizontalGap   marginBottom   marginTop   verticalAlign   verticalGap  

mx.core.UIComponent クラスから継承されるスタイル
backgroundAlpha   backgroundColor   backgroundDisabledColor   backgroundImage   backgroundSize   barColor   borderCapColor   borderColor   borderSides   borderStyle   borderThickness   cornerRadius   disabledColor   dropShadow   errorColor   fillColors   highlightColor   modalTransparency   scrollTrackColor   selectedFillColors   shadowCapColor   shadowColor   shadowDirection   shadowDistance   symbolBackgroundColor   symbolBackgroundDisabledColor   symbolBackgroundPressedColor   symbolColor   symbolDisabledColor   themeColor  

mx.core.UIObject クラスから継承されるスタイル
color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap  



メソッドの詳細

getDividerAt

getDividerAt( i:Number) :  mx.containers.dividedboxclasses.BoxDivider

この DividedBox コンテナ内にある指定された BoxDivider オブジェクトへの参照を返します。

パラメータ
    i:Number - 0 から始まる、仕切りのインデックスです。左または上から数えます。

getDividerCount

getDividerCount( ) :  Number

仕切りの数です。この数は常に numChildren - 1 です。

戻り値
     仕切りの数です。

measure

measure( ) :  Void

Box の measure メソッドをオーバーライドします。この関数は Box バージョンとほぼ同一ですが、最小および最大の境界条件に関するテストをより広範に実行します。これは、DividedBox では、コントロールの最小値より低い値を設定できるためです。

moveDivider

moveDivider( i:Number, amt:Number) :  Number

特定の仕切りを、指定されたピクセル数移動します。

パラメータ
    i:Number - 0 から始まる、仕切りのインデックスです。左または上から数えます。
    amt:Number - 仕切りを動かすピクセル数です。負の値を指定すると仕切りを上または左に動かすことができます。仕切りの動きは、ユーザーが手動で移動する場合と同様の制約を受けます。

戻り値
     仕切りが実際に移動したピクセル数です。値が 'undefined' である場合は、無効な仕切りインデックス (i) が使用されたか、ユーザーが現在仕切りを移動しようとしています。

preLayoutAdjustment

preLayoutAdjustment( )

アルゴリズムではあらかじめ用意されたレイアウトが採用され、空き領域が残らないように、また、明示的な最小値または最大値のみが使用されるようにします。まず、すべての子の % の合計を計算して、100% 以上あることを確認します。100% 以上あれば、完了です。そうでない場合は、残りを最後のコンポーネントに追加します。または、パーセント値をすべての % コンポーネントに均等に配分します。



プロパティの詳細

liveDragging

liveDragging:Boolean  

true の場合、ユーザーが仕切りをドラッグしている間、その仕切りに隣接する子のサイズが連続的に変化します。false の場合、ユーザーが仕切りを解放するまでサイズが変更されません。デフォルトは false です。


例
DividedBoxExample.mxml 
<?xml version="1.0"?>
<!-- DividedBox レイアウトの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" width="100%" height="100%"
backgroundColor="#FFFFFF">

<mx:Panel title="DividedBox Layout Panel" width="85%" height="100%" marginTop="10">

<mx:DividedBox direction="horizontal" width="100%" height="100%">

<mx:Canvas label="Canvas 1" width="100%" height="100%" backgroundColor="#FFFFCC">
<mx:Label text="Add components here" fontSize="20" fontStyle="italic"
fontWeight="bold" fontFamily="Times New Roman"/>

</mx:Canvas>

<mx:Canvas label="Canvas 2" width="100%" height="100%" backgroundColor="#99CCFF">
<mx:Label text="Add components here" fontSize="20" fontStyle="italic"
fontWeight="bold" fontFamily="Times New Roman"/>
</mx:Canvas>

</mx:DividedBox>

</mx:Panel>

</mx:Application>