mx.containers
Tile クラス



直接の既知のサブクラス
mx.charts.Legend
Tile クラス
mx.containers.Container の拡張Tile コンテナは、均等なサイズのセルで構成されるグリッド内に子を配置します。セルのサイズを指定するには、tileWidth および tileHeight プロパティを使用します。または、最大の子のサイズに基づいて自動的にセルサイズを決定することもできます。Tile コンテナの direction プロパティは、セルが Tile の左上の角から水平に配置されるか、垂直に配置されるかを決定します。
MXML シンタックス
<mx:Tile> タグは、<mx:Container> タグのプロパティ、スタイル、およびイベントを継承し、次のプロパティを追加します。
<mx:Tile
direction="value"
horizontalAlign="value"
horizontalGap="value"
marginBottom="value"
marginTop="value"
tileHeight="value"
tileWidth="value"
verticalAlign="value"
verticalGap="value"
>
...
子タグ
...
</mx:Tile>
例を参照するにはここをクリックしてください
| layoutChildren( )
: Void
サイズ変更に反応して、このコンテナの子の位置およびサイズを設定します。 |
| measure( )
: Void
Tile コンテナの推奨、最小、および最大サイズを計算します。 |
horizontalAlign | CSS の継承 : なし
タイルセル内に子を配置する水平方向の場所です。有効な値は、left、center、および right です。デフォルト値は left です。値が left の場合、各子の左端がセルの左端に揃えられます。値が right の場合、各子の右端がセルの右端に揃えられます。値が center の場合、各子がセル内で水平方向の中央に揃えられます。 |
horizontalGap | 型 : Number 形式 : Length CSS の継承 : なし
子同士の水平方向の間隔を示すピクセル数です。デフォルト値は 8 です。 |
marginBottom | 型 : Number 形式 : Length CSS の継承 : なし
コンテナの下の境界とコンテンツ領域との間のピクセル数です。デフォルト値は 0 です。 |
marginTop | 型 : Number 形式 : Length CSS の継承 : なし
コンテナの上の境界とコンテンツ領域との間のピクセル数です。デフォルト値は 0 です。 |
verticalAlign | CSS の継承 : なし
タイルセル内に子を配置する垂直方向の場所です。有効な値は、top、middle、および bottom です。デフォルト値は top です。値が top の場合、各子の上端がセルの上端に揃えられます。値が bottom の場合、各子の下端がセルの下端に揃えられます。値が middle の場合、各子がセル内で垂直方向の中央に揃えられます。 |
verticalGap | 型 : Number 形式 : Length CSS の継承 : なし
子同士の垂直方向の間隔を示すピクセル数です。デフォルト値は 6 です。 |
layoutChildren
layoutChildren( )
: Void
サイズ変更に反応して、このコンテナの子の位置およびサイズを設定します。layoutChildren() メソッドの詳細については、UIObject.layoutChildren() メソッドを参照してください。 このメソッドは、Tile コンテナのコンテンツ領域内 (余白の内側の領域) にある、均等なサイズのセルで構成される格子状のグリッド内に子を配置します。セルのサイズを決定する方法の詳細については、tileWidth および tileHeight プロパティを参照してください。
セル同士の間隔は、horizontalGap および verticalGap スタイルによって決定されます。各セル内に子を配置する場所は、horizontalAlign および verticalAlign スタイルによって決定されます。
子を並べていく方向は、direction プロパティによって決定されます。最初のセルは、常にコンテンツ領域の左上に配置されます。direction が horizontal の場合、セルは一番上の行の左から右に、次に 2 行目の左から右に、という順序で配置されます。direction が vertical の場合、セルは一番左の列の上から下に、次に 2 列目の上から下に、という順序で配置されます。
子の width または height がパーセント値に設定されている場合、その子はタイルセルの指定した比率に合わせて縦方向または横方向にサイズ変更されます。
measure
measure( )
: Void
Tile コンテナの推奨、最小、および最大サイズを計算します。measure() メソッドの詳細については、UIObject.measure() メソッドを参照してください。 このメソッドでは、最初に各タイルセルのサイズを計算します。セルのサイズを決定する方法の詳細については、tileWidth および tileHeight プロパティを参照してください。
子を持つ Tile コンテナの推奨サイズは、行数と桁数が等しい N x N のグリッドでセルを表示するのに必要なスペースに、Tile コンテナの余白と境界を加えたサイズです。ただし、次の場合については特別に扱われます。
- 水平方向の Tile コンテナで、width がパーセント値に設定されている場合、すべての子が単一の行に配置されます。
- 水平方向の Tile コンテナで、preferredWidth が明示的に設定されている場合、その設定値に基づいて、水平方向に収まるセルの数と、すべての子を収めるために必要な高さが計算され、行数と桁数が異なる M x N のグリッドが生成されます。
- 垂直方向の Tile コンテナで、height がパーセント値に設定されている場合、すべての子が単一の列に配置されます。
- 垂直方向の Tile コンテナで、preferredHeight が明示的に設定されている場合、その設定値に基づいて、垂直方向に収まるセルの数と、すべての子を収めるために必要な幅が計算され、行数と桁数が異なる N x M のグリッドが生成されます。
- 子が存在しない場合、推奨サイズは余白と境界だけを表示するのに必要な大きさです。
子を持つ Tile コンテナの最小サイズは、単一のタイルセルおよび余白と境界を表示するのに必要な大きさです。- 子が存在しない場合、最小サイズは余白と境界だけを表示するのに必要な大きさです。
このメソッドでは、Tile コンテナの最大サイズは変更されず、無制限のままとなります。
direction
direction:String
コンテナ内に子を配置する方法を指定します。有効な値は horizontal と vertical です。デフォルト値は horizontal です。Tile のサブクラスである Legend コンテナの場合、デフォルト値は vertical です。どちらの場合も、最初の子は Tile コンテナの左上に配置されます。値が horizontal の場合、セルは一番上の行の左から右に、次に 2 行目の左から右に、という順序で配置されます。値が vertical の場合、セルは一番左の列の上から下に、次に 2 列目の上から下に、という順序で配置されます。
tileHeight
tileHeight:Number
各タイルセルの高さです (ピクセル単位)。デフォルト値は undefined です。このプロパティが undefined の場合、各セルの高さは、最も高さが大きい子の推奨される高さに基づいて決定されます。このプロパティを設定すると、この計算よりも設定値が優先されます。
tileWidth
tileWidth:Number
各タイルセルの幅です (ピクセル単位)。デフォルト値は undefined です。このプロパティが undefined の場合、各セルの幅は、最も幅が大きい子の推奨される幅に基づいて決定されます。このプロパティを設定すると、この計算よりも設定値が優先されます。
| TileLayoutExample.mxml |
<?xml version="1.0"?>
<!-- Tile レイアウトの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">
<mx:Panel title="Tile Panel">
<mx:Tile marginBottom="10" borderStyle="inset" verticalGap="15" id="myFlow"
marginLeft="10" backgroundColor="#FFFFCC" marginTop="10" marginRight="10"
horizontalGap="10" direction="horizontal">
<mx:Button label="1" height="50" width="75"/>
<mx:Button label="2" height="50" width="75"/>
<mx:Button label="3" height="50" width="75"/>
<mx:Button label="4" height="50" width="75"/>
<mx:Button label="5" height="50" width="75"/>
<mx:Button label="6" height="50" width="75"/>
</mx:Tile>
</mx:Panel>
</mx:Application>
|