チェックボックス

4D v16.3

チェックボックス

使用方法

チェックボックスを使用して、バイナリデータ（true-false）の入力や表示を行います。これはボタンタイプの一つです。チェックボックスの状態は選択、未選択のいずれかになります。その効果はメソッドで管理します。他のボタンと同じように、フォームが初めて開かれた時は、チェックボックスが0 に初期化されています。チェックボックスが選択されると、チェックボックスに割り当てられたメソッドが実行されます。

チェックボックスは小さな四角形の右側にテキストを表示します。このテキストはプロパティリストのオブジェクトテーマにあるタイトルエリアで設定します。このエリアにXLIFFまたはSTR#参照の形式でラベルを指定できます (付録 C: XLIFFアーキテクチャー参照)。

ユーザがオブジェクトをクリックすると、ボックスが選択されます。チェックボックスが選択されると、その値は1 になります。チェックボックスが選択されていない場合、その値は0 になります。フォーム上のすべてのチェックボックスは選択/未選択のいずれかの状態になります。

チェックボックスのグループを使用すると、複数の候補を選択できるようになります。

チェックボックスとしてフォーマットされたブールフィールドとは異なり、チェックボックス変数の値は自動的に保存されません。メソッドを用いてこの変数を管理します。

注: 3D チェックボックスの動作はチェックボックスと同じですが、その外観（例えば選択済み/未選択状態の表現方法）は3D ボタンファミリーのプロパティで設定されます。詳細は3Dボタン、3Dチェックボックス、3Dラジオボタンを参照してください。

3 ステートチェックボックス

チェックボックスオブジェクトは3 番目の状態を受け入れます。この3 番目の状態とは中間的な状態であり、一般的には表示のために用いられます。この状態を使用すると、例えばあるプロパティは全オブジェクトの中ではなく、選択オブジェクト群の中に存在する、ということを表現することができます。

チェックボックスでこの3 番目の状態を制御するには、プロパティリストの"表示"テーマにおいて3 ステートプロパティを設定しなくてはなりません。:

このプロパティは、数値タイプの変数に関連付けられた標準のチェックボックスに対してのみ使用できます。3D チェックボックスやブールフィールドのチェックボックスには3 ステートプロパティを利用することができません（ブールフィールドは中間状態になりません）。

チェックボックスが3 番目の状態になると、チェックボックスに関連付けられた変数は値2を返します。

Tip: 入力モードにおいて3 ステートチェックボックスはチェックなし / チェック / 中間状態 / チェックなしという順序でそれぞれの状態を順に表示します。一般的にこの中間状態は入力モードではあまり役に立たないため、2 という値になった場合は、コード上で変数の値を強制的に0 に設定し、チェックされた状態からチェックなしの状態へ直接移行してください。