setParent

移動先: 概要 戻り値 フラグ MEL の例

概要

setParent [-defineTemplate string] [-menu] [-topLevel] [-upLevel] [-useTemplate string] [string]

setParent は「元に戻す」が可能、「照会」が可能、「編集」が不可能です。

コントロールは、コントロール レイアウトにペアレント化する必要があります。コントロール レイアウトは、別のコントロール レイアウトまたはウィンドウにペアレント化されることがあります。メニューは、ウィンドウまたはメニュー バー レイアウトにペアレント化されることがあります。このようなすべての場合において、setParent コマンド（フラグなし）はカレントのデフォルトの親を示します。

メニュー項目は、メニューにペアレント化する必要があります。デフォルト メニューの親を指定するには、コマンド setParent -m/menu を使用します。-sm/subMenu を使用して作成されるメニュー項目オブジェクトは、メニュー オブジェクトとして扱われる場合もあるので注意してください。

オブジェクトの作成時に明示的に -p/parent フラグを設定した場合、デフォルトの親は無視されます。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-upLevel(-u)
階層の 1 つ上のレベルに移動します。「..」を使用するのと同じです。
-topLevel(-top)
階層の最上位レベルに移動します。「/」を使用するのと同じです。
-menu(-m)
メニュー項目の親メニュー
-defineTemplate(-dt)	string
他の任意のフラグと引数を解析し、かつ指定した名前でコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName がカレントのテンプレートとして設定されていれば、 その後コマンドが実行されるたびに、この引数がデフォルトの引数として使用されます。
-useTemplate(-ut)	string
強制的に、コマンドにカレント以外の名前で指定したコマンド テンプレートを使用させます。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL の例

//  Create a window with a menu bar and two menu bar layouts.
//
string $window = `window -menuBar true -widthHeight 300 200`;
string $fileMenu = `menu -label "File"`;
menuItem -label "Open";

paneLayout -configuration "vertical2";

string $leftMenuBarLayout = `menuBarLayout`;
string $leftMenu = `menu -label "Left"`;
menuItem -label "One";
setParent ..;

menuBarLayout;
menu -label "Right";
string $rightSubMenu = `menuItem -label "Colors" -subMenu true`;
setParent ..;
showWindow $window;

//  Add item to the "File" menu.
//
setParent -menu $fileMenu;
menuItem -label "Save";

//  Add item to the "Left" menu, explicitly ignore default parent
//    by setting -p/parent flag.
//
menuItem -parent $leftMenu -label "Two";

//  Add more items to the "File" menu because it is still the
//    default parent.
//
menuItem -divider true;
menuItem -label "Close";

//  Add another menu to the left menu bar layout.
//
setParent $leftMenuBarLayout;
menu -label "Middle";
menuItem -label "Three";

//  Add items to right sub menu.
//
setParent -menu $rightSubMenu;
menuItem -label "Red";
menuItem -label "Blue";
menuItem -label "Green";