Checkbutton UI コントロール

ユーザインタフェースコントロール > 共通プロパティ > レイアウト > タイプ > Checkbutton

checkbutton コントロールは、チェックボックスと同じように、オンおよびオフの 2 つの状態を持つ押しボタンをロールアウトに配置するために使用します。クリックして、オンとオフを連続して切り替えることができます。

構文は次のようになります。

checkbutton <name> [<caption>] [ highlightColor:<color> ] \ 
[ toolTip:<string> ] [ checked:<boolean> ] [ images:<image_spec_array> ] \ 
[ border:<boolean> ]

checkbutton 項目の位置合わせの既定値は、 #center です。

例:

rollout test "Test"
(
checkbutton setup "Setup" checked:true tooltip:"Opens setup panels"
on setup changed state do
if state == on then
  openRollout setup_pan
else
  closeRollout setup_pan
)

パラメータ

checked:

チェックボタンの初期状態です。既定値は off です。

highlightColor:

チェックボタンを押した(またはオンにした)状態のバックグラウンドカラーです。既定値はライトグレーで、3ds Max ユーザインタフェース規則に従います。

toolTip:

チェックボタンのツールチップ用のテキストです。指定しない場合、ツールチップは表示されません。

images:

チェックボタンにビットマップイメージを提供するためのイメージ仕様配列です。指定すると、 <label> は無視されて、ボタンの内容がビットマップに置き換えられます。

形式は次のとおりです。

images:#(<image>, <maskImage>, <count_integer>, <enabled_out_image_index>, <enabled_in_image_index>, <disabled_out_image_index>, <disabled_in_image_index>)

ここでは、 <image> および <maskImage> は、ビットマップファイル名の文字列でも、MAXScript ビットマップ値でもかまいません。 <count_integer> には、ビットマップ内のサブイメージの数を指定し、 image_index 値には、ボタンの 4 つの状態にビットマップのどのサブイメージを使用するかを指定します。

例:

bm1 = render camera:$cam01 outputSize:[80,60]
...
checkbutton foo images:#(bm1, undefined, 1, 1, 1, 1, 1)

これは、チェックボタンのイメージとしてレンダリングを使用します。

checkbutton decay images:#("dcybtns.bmp","dcymask.bmp", 6, 1, 4, 1, 4)

これは、ビットマップのサブイメージ 1 と 4 を使用します。 dcybtns.bmp および dcymask.bmp は、それぞれチェックボタンのオフまたはオン状態に対応しています。

イメージボタンも参照してください。

border:

true に設定した場合、または指定しなかった場合、checkbutton は境界線付きで描画されます。これは、3ds Max 2009 より前のバージョンでは既定値の動作でした。

false に設定すると、チェックボタンは境界線なしで描画され、UI の背景が付いたものになります。チェックボタンが有効になっている場合は、チェックボタンが押されたとき、チェックマークが付いているとき、および .checked プロパティが true に設定されていて、マウスが上に置かれているときに、境界線が表示されます。

3ds Max 2009 以降 で使用可能です。

プロパティ:

<checkbutton>.checkedBoolean

チェックボタンの状態です。オン( true )またはオフ( false )です。

<checkbutton>.state Boolean

.checked と同義です。

<checkbutton>.images Array

チェックボタンのイメージ設定の配列を設定します。このプロパティは書き込み専用です。

3ds Max 8 以降では、値を undefined に設定すると、コントロールは、イメージではなくキャプションを表示する状態に戻ります。

例:

-- re-render, update button
bm1 = render()
foo.images = #(bm1, undefined, 1, 1, 1, 1, 1)

<checkbutton>. tooltip String

チェックボタンのツールチップ文字列を取得/設定します。

3ds Max 9 以降で使用可能です。

例:

--Evaluate this script, then roll over the checkbutton to read the tooltip.
--Check the checkbutton, roll over again to see the new tooltip.
--Uncheck the checkbutton and roll over once again to see the new tooltip.
(
rollout test "Test"
(
checkbutton chk_test "Check Me!" tooltip:"This is a tooltip"
on chk_test changed state do
chk_test.tooltip = if state then "I am checked!" else "I am unchecked!"
)
createDialog test
)

イベント

on <checkbutton> changed <arg> do <expr>

状態を変えるためにチェックボタンをクリックすると呼び出されます。 <arg> 引数には、新しいチェックボタンの状態であるオン( true )またはオフ( false )が含まれます。

注: <arg> は、イベントハンドラのコンテキストではローカル変数であることに注意してください。この変数をハンドラ内で使用すると、チェックボタンの新しい状態に従って処理を行うことができます。

例:

utility testCheckButton "Test The CheckButton"
(
checkbutton myCheckButton "Check Me!"
-- theState is a user variable name that will contain the state
-- of the checkbox whenever the change handler is executed
on myCheckButton changed theState do
(
if theState == true then
myCheckButton.text = "Uncheck Me!"
else
myCheckButton.text = "Check Me!"
)
)--end utility

on <checkbutton> rightclick do <expr>

ボタン上で右マウスボタンが放されたときに、呼び出されます。3ds Max 8 以降 で使用可能です。

Checkbutton UI コントロール

関連事項