ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

dimWhen [-clear] [-false] [-true] string string

dimWhen は、取り消し可能、照会不可能、および編集不可能です。

このメソッドは、指定した UI オブジェクト(1 番目の引数)を、指定した条件(2 番目の引数)にアタッチして、条件が特定の状態になったときにオブジェクトが暗くなるようにします。

オブジェクトが存在しない場合はエラーになります。条件は存在しなくても問題ありません。その条件が存在するようになるまでは、プレースホルダが使用されます。

UI オブジェクトは、コントロールまたはメニュー項目のどちらかである必要があります。

戻り値

なし

フラグ

clear, false, true
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-false(-f) create
条件が false である場合にオブジェクトが暗く表示されます。
-true(-t) create
条件が true である場合にオブジェクトが暗く表示されます (既定)。
-clear(-c) create
暗く表示する条件が除去されます。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

//    Create a window with a menu item and button that will dim if
//    there are no objects selected in the scene.
//
string $window = `window -menuBar true -title "dimWhen Example"`;
menu -label "Edit";
string $menuItem = `menuItem -label "Delete Selection" -command ("delete")`;
columnLayout -adjustableColumn true;
string $button = `button -label "Delete Selection" -command ("delete")`;

//    Create a few buttons to create some objects, select all the objects in
//    the scene, and clear the selection.
//
button -label "Create Objects" -command ("sphere; cone; cylinder;");
button -label "Select All" -command ("select -all");
button -label "Select Nothing" -command ("select -clear");

//    Add the dim conditions.
//
dimWhen -false SomethingSelected $button;
dimWhen -false SomethingSelected $menuItem;

showWindow $window;