CheckBox コントロール -- Flex 2.01

CheckBox コントロールは、チェックマークの表示と非表示 (空) の状態を保持するグラフィカルコントロールです。相互排他的でない一連のブール値 (true または false) を収集する必要があるときに、CheckBox コントロールを使用します。

CheckBox コントロールにはテキストラベルを 1 つ追加して、左、右、上、下のいずれかの位置に表示することができます。CheckBox コントロールのラベルは、コントロールの境界内に収まるようにクリッピングされます。

CheckBox コントロールまたは対応するテキストをクリックすると、チェックがオンの状態からチェックがオフの状態へ、またはチェックがオフの状態からチェックがオンの状態に変化します。

無効状態の CheckBox コントロールには、チェックがオンとチェックがオフの 2 つの状態があります。デフォルトでは、無効状態の CheckBox コントロールでは、有効状態の CheckBox コントロールとは異なる背景とチェックマークの色が表示されます。

CheckBox コントロールには、次のデフォルトプロパティがあります。

プロパティ	デフォルト値
デフォルトサイズ	ラベルを表示するために必要なサイズです。
最小サイズ	0
最大サイズ	制限なし

サブトピック

CheckBox コントロールの作成

次の例のように、MXML で CheckBox コントロールを定義するには、<mx:CheckBox> タグを使用します。MXML の他の場所 (別のタグまたは ActionScript ブロック) のコンポーネントを参照する場合は、id 値を指定します。

<?xml version="1.0"?>
<!-- controls\checkbox\CBSimple.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:VBox>
        <mx:CheckBox width="100" label="Employee?"/> 
    </mx:VBox>
</mx:Application>

selected プロパティを使用して、デフォルトでチェックがオンになるチェックボックスを生成することもできます。

<?xml version="1.0"?>
<!-- controls\checkbox\CBSelected.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:VBox>
        <mx:CheckBox width="100" label="Employee?" selected="true"/> 
    </mx:VBox>
</mx:Application>

CheckBox コントロールのユーザー操作

CheckBox コントロールが有効な状態でクリックすると、その CheckBox コントロールにフォーカスが移動し、最初の状態に応じてチェックがオンの状態またはチェックがオフの状態の外観が表示されます。CheckBox コントロールの領域全体をクリック領域といいます。CheckBox コントロールのテキストがアイコンよりも大きい場合、クリック可能な領域がアイコンの上下に拡張されます。

ユーザーがマウスボタンを押し下げ、そのままの状態でマウスポインタを CheckBox コントロール (またはそのラベル) の領域外に移動すると、その CheckBox コントロールはフォーカスを保持したまま、最初の状態に戻ります。ユーザーが CheckBox コントロール上でマウスボタンを離さない限り、チェックボックスの状態は変化しません。

無効状態の CheckBox コントロールに対して操作を実行することはできません。