| メソッド | プロパティ | エフェクト | イベント | スタイル | フレームあり | フレームなし |
FormItem コンテナはラベルおよび子を定義し、水平または垂直に配置します。子は、コントロールまたはその他のコンテナです。1 つの Form コンテナに複数の FormItem コンテナを含めることができます。
MXML シンタックス
<mx:FormItem> コンテナは、Canvas クラスのすべてのプロパティ (marginLeft を除く) と、次のプロパティを継承します。
<mx:FormItem
direction="vertical|horizontal"
horizontalAlign="left|center|right"
horizontalGap="6"
indicatorGap="15">
label="No default."
labelWidth="Default value is calculated from width of the label text."
marginBottom="0"
marginRight="0"
marginTop="0"
required="false|true"
verticalGap="6"
...
child tags
...
/>
関連項目
Form
FormHeading
| メソッド | |
| layoutChildren( )
: Void サイズ変更に反応して、このコンテナの子の位置およびサイズを設定します。 |
| measure( )
: VoidFormItem の推奨、最小、および最大サイズを計算します。 |
| mx.containers.Container クラスから継承されるメソッド |
createChildren draw executeChildBindings getViewMetrics getViewMetricsAndMargins init |
| mx.core.UIComponent クラスから継承されるメソッド |
drawFocus getFocus getFocusManager setEnabled setFocus |
| プロパティ | |
| direction:String 子の方向です。 |
| label:String FormItem のテキストラベルです。 |
| labelObject:Object
[読み取り専用]
FormItem コンテナのラベルにアクセスするための読み取り専用プロパティです。 |
| required:Boolean true の場合、FormItem の子がユーザー入力を要求していることを示すインジケータを表示します。 |
| mx.core.View クラスから継承されるプロパティ |
baselinePosition className numChildren version |
| mx.core.UIComponent クラスから継承されるプロパティ |
enabled errorString tabEnabled tabIndex version |
| エフェクト |
| mx.core.UIComponent クラスから継承されるエフェクト |
focusInEffect focusOutEffect |
| mx.core.UIObject クラスから継承されるエフェクト |
creationCompleteEffect hideEffect mouseDownEffect mouseOutEffect mouseOverEffect mouseUpEffect moveEffect resizeEffect showEffect |
| イベント |
| mx.containers.Container クラスから継承されるイベント |
childrenCreated scroll |
| mx.core.View クラスから継承されるイベント |
childCreated childDestroyed childIndexChanged |
| mx.core.UIComponent クラスから継承されるイベント |
focusIn focusOut invalid keyDown keyUp valid valueCommitted |
| スタイル | |
horizontalAlign | CSS の継承 : なし子の水平方向の配置です。デフォルトは left です。有効な値は、left、center、および right です。 |
horizontalGap | 型 : Number 形式 : Length CSS の継承 : なし子同士の水平方向の間隔を示すピクセル数です。デフォルト値は 6 です。 |
indicatorGap | 型 : Number 形式 : Length CSS の継承 : ありラベルと子コンポーネントの間隔を示すピクセル数です。デフォルト値は 14 です。 |
labelWidth | 型 : Number 形式 : Length CSS の継承 : ありフォームラベルの幅です。デフォルトは、フォーム内で最も長いラベルの長さです。 |
marginBottom | 型 : Number 形式 : Length CSS の継承 : なしコンテナの下境界線とコンテンツ領域の間隔を示すピクセル数です。デフォルト値は 0 です。 |
marginRight | 型 : Number 形式 : Length CSS の継承 : なしコンテナの右境界線とコンテンツ領域の間隔を示すピクセル数です。デフォルト値は 0 ピクセルです。 |
marginTop | 型 : Number 形式 : Length CSS の継承 : なしコンテナの上境界線とコンテンツ領域の間隔を示すピクセル数です。デフォルト値は 0 です。 |
verticalGap | 型 : Number 形式 : Length CSS の継承 : なし子同士の垂直方向の間隔を示すピクセル数です。デフォルトは 8 です。 |
| mx.core.UIObject クラスから継承されるスタイル |
color fontFamily fontSize fontStyle fontWeight horizontalGap leading marginLeft marginRight textAlign textDecoration textIndent verticalGap |
| メソッドの詳細 |
layoutChildren( )
: Void
layoutChildren() メソッドの詳細については、UIObject.layoutChildren() メソッドを参照してください。 FormItem コントロールの位置を設定する方法については、FormItem.measure() メソッドを参照してください。
ラベルはラベル領域の右に寄せられます。Form 内のすべてのラベルが一直線に配置されます。
required プロパティが true の場合、ラベルとコントロールの間に、フィールドが必要なことを示す記号が配置されます。
コントロールは、measure() メソッドで説明されている方法で列内に配置されます。horizontalAlign スタイルプロパティは、コントロールが水平方向に配置される場所を指定します。
direction プロパティが vertical の場合、width が設定されていない子の幅は、コントロール領域の 1/4 の幅になる直近値に切り上げられた preferredwidth を使用します。これは、コントロールの右端がぎざぎざになるのを防ぐために実行されます。
このメソッドは、何を実行する前にも super.layoutChildren() メソッドを呼び出します。
measure( )
: Void
measure() メソッドの詳細については、UIObject.measure() メソッドを参照してください。 FormItem.measure() メソッドは、使用する列の数を最初に決定します。direction プロパティが horizontal の場合、可能であればすべてのコントロールが 1 行に配置されます。コントロールが 1 行に収まらない場合は、2 行に分割されます。direction が vertical の場合、コントロールが 1 列に配置されます。
FormItem には、ラベル領域とコントロール領域があります。ラベル領域のサイズの計算方法は、コントロールの方向にかかわりなく同一です。コントロール領域のサイズの計算方法は、使用される行および列の数によって異なります。
ラベル領域の幅は、labelWidth スタイルプロパティによって決定されます。このプロパティが undefined の場合 (これがデフォルトです)、親 Form コンテナ内で最大のラベルの幅が使用されます。
すべての子が 1 行に配置されている場合、コントロール領域の幅は、すべての子の幅に、子同士の horizontalGap 間隔を加えた値です。
子が 1 列に配置されている場合、コントロール領域の幅は最も広い子の幅です。
子が複数の行および列に配置されている場合、最も広い子の幅が列幅になり、コントロール領域の幅は、列幅に列数を掛けた値に、各子同士の horizontalGap 間隔を加えた値です。
_measuredPreferredWidth は、ラベル領域の幅に、コントロール領域の幅と、indicatorGap スタイルプロパティの値を加えた値に設定されます。marginLeft および marginRight スタイルプロパティの値と、境界線の幅の値も追加されます。
_measuredPreferredHeight は、すべての子の行の preferredHeights の合計に、各子同士の verticalGap 間隔を加えた値に設定されます。marginTop および marginBottom スタイルプロパティと、境界線の高さも追加されます。
_measuredMinWidth は、ラベル領域の幅に、コントロール領域の最小幅と、indicatorGap スタイルプロパティの値を加えた値に設定されます。marginLeft および marginRight スタイルプロパティの値と、境界線の幅の値も追加されます。
| プロパティの詳細 |
direction:String
vertical または horizontal です。デフォルト値は vertical です。direction が vertical の場合、FormItem の子は、FormItem ラベルの右側に垂直に重ねられます。direction が horizontal の場合、子は 1 行に配置されるか (収まる場合)、または同一サイズの 2 行に配置されます。
FormItem の子のレイアウトをさらに制御する必要がある場合は、FormItem の子として Grid や Tile などのコンテナを配置し、このコンテナの内部にコントロールを配置します。
label:String
labelObject:Object [読み取り専用]
required:Boolean
このプロパティは、インジケータの表示のみを制御します。入力を検証する必要がある場合は、子に検証を組み込む必要があります。