R-Script コントロール作成関数

■Checkbox

　チェックボックスを作成します。

Checkbox( ID$, default, caption$ [, Key$, Entry$ [,<OnValue | OnValue$>, <OffValue | OffValue$>]] [ , flag] )

●引数

　ID$ … ここで作成されるコントロールのIDを指定します。他のコントロールのIDと重複してはいけません。
　default … レジストリエントリに関連づけない場合、または、レジストリエントリが読み込めない場合のチェック状態(1:ON, 0:OFF)を指定します。
　caption$ … は、チェックボックスの右側に表示される文字列を指定します。アクセラレータキーを指定するには、&の後に英文字を書きます。
　Key$ … チェックボックスを関連づけるレジストリキー。
　Entry$ … チェックボックスを関連づけるエントリ名。このエントリの値が0ならばチェックなし、そうでなければチェック有りになります。
　OnValue または OnValue$ … 通常では、レジストリエントリの値が0ならチェックなし、そうでなければチェック有りなどとしていますが、そうしたくない場合に指定します。このチェックボックスが数値型のエントリに関連づけられているのならば数値で、文字列型のエントリに関連づけられているのならば文字列で指定します。
　OffValue または OffValue$ … 通常では、レジストリエントリの値が0ならチェックなし、そうでなければチェック有りなどとしていますが、そうしたくない場合に指定します。このチェックボックスが数値型のエントリに関連づけられているのならば数値で、文字列型のエントリに関連づけられているのならば文字列で指定します。
　flag … コントロールに与えるフラグを指定します。

●解説

　Key$, Entry$ が指定されると、チェックボックスが作成されるときに、このレジストリエントリが参照され、データが0でなければチェックされ、0ならばチェックされません(後述するOnValue/OnValue$とOffValue/OffValue$で、この動きを変えることができます)。

　defaultは、レジストリエントリが見つからなかった場合、またはKey$とEntry$を省略した場合に利用されます。0がチェックなしで、1がチェックありです。(ここではON/OFFしか指定できません。むりやり半チェック状態を指定したい場合は、チェックボックス作成後にSetCheckBox()を呼び出して下さい)
　編集ダイアログで[OK]または[適用]が押されると、チェックボックスの状態により、レジストリエントリに自動的にデータが書き込まれます。

　OnValue/OnValue$とOffValue/OffValue$は、レジストリ上のエントリ値がどのような値の時に、チェックボックスをオン/オフにするかを決めます。双方を数値型にするか、双方を文字列型にします。デフォルトでは、1と0です。つまりここに「0,1」とか「"no","yes"」のような順で指定すると、デフォルトの動作とは逆の動作をすることになります。

　flagに CHECK_SZ01 を指定すると、文字列型のレジストリエントリのデータが "1" ならばチェックされ、"0" ならばチェックされません。
　flagに CHECK_SZYN を指定すると、文字列型のレジストリエントリのデータが "yes" ならばチェックされ、"no" ならばチェックされません。
　flagに CHECK_SZTF を指定すると、文字列型のレジストリエントリのデータが "true" ならばチェックされ、"false" ならばチェックされません。

●戻り値

　成功 …… 1
　失敗 …… 0

●サンプル

checkbox( "LockTaskbar", 0, "「タスクバーを固定する」を無効化する", Key$, "LockTaskbar", CTRL_NOTIFY | DELETE_DEFAULT )

　コントロールの作成関数一覧へ
　関数書式の見方

※このページは、ソフトウェアに付属のヘルプファイルをWeb用に再構築したものです。大部分に自動変換を施しているため、一部は正しく変換しきれずに表示の乱れている箇所があるかもしれませんが、ご容赦下さい。また、本ドキュメントはアーカイブドキュメントであり、内容は「いじくるつくーる」最終公開時点、あるいは、それより古い時点のものとなっております。一部、内容が古くなっている箇所があるかと思いますが、あらかじめご了承下さい。
※このページへは、自由にリンクしていただいてかまいません。
このページに関するご意見の受け付けは終了しています。

/トップ/いじくるつくーる/ダウンロード/WebHelp/ヘルプトップ/