ワークスペース コントロールを記述する

MEL を使用してワークスペース コントロールを作成する

次の例では、MEL を使用してワークスペース コントロールを作成する最も簡単な方法を示します。この例では、このスクリプトが customWorkspaceControlFile.mel にあることが前提となります。

	global proc createCustomWorkspaceControlUI()
	{
	                columnLayout;
	                button;
	                button;
	                button;
	}
	 

次のコマンドを実行して、最初のコントロールを作成します。

workspaceControl -retain false -floating true 
-uiScript "if(!`exists createCustomWorkspaceControlUI`) source customWorkspaceControlFile; createCustomWorkspaceControlUI();" 
myCustomWorkspaceControl;

Python と Pyside のバインディングを使用してワークスペース コントロールを作成する

Maya コマンド スクリプトを使用して、Python でワークスペース コントロールを作成することができます。ワークスペース コントロールの UI の内容が PySide ベースの場合は、PySide のみが適用されます。

次の操作を実行して、PySide UI 内でワークスペース コントロールを作成します。

1. MayaQWidgetDockableMixin クラスから最上位のウィジェットを取得します。
2. dockable が True に設定された状態で show() に対する呼び出しを使用して、ウィジェットを開きます。
3. uiScript に、このウィジェットを再作成するスクリプトを設定します。このスクリプトでは、MQtUtil.addWidgetToMayaLayout を使用して、再作成されたウィジェットを復元されたワークスペース コントロール(MQtUtil.findControl を使用して検索)にペアレント化する必要があります

Python を使用してワークスペース コントロールを作成する方法の詳細については、dockableWorkspaceWidget.py 開発キット サンプルを参照してください。このサンプルを実行するには、スクリプト エディタ(Script Editor)で開いて実行します。「PyQt および PySide ウィジェットのベスト プラクティス」も参照してください。

C++ を使用してワークスペース コントロールを作成する

C++ を使用している場合は、最初に workspaceControl MEL コマンドを使用してワークスペース コントロールを作成する必要があります。このコマンドを実行するには、MGlobal::executeCommand() メソッドを使用します。次に、MQtUtil::addWidgetToMayaLayout() メソッドを使用して C++ で作成された Qt UI をワークスペース コントロールにペアレント化できます。

workspaceControlCmd.cpp サンプルは、ワークスペース コントロールおよびそれらを含む UI を生成するコマンドの作成方法を示します。また、この UI を workspaceControl の uiScript フラグに渡して、再度開くときに UI を復元する方法も示します。このコマンドはプラグインの一部であるため、requiredPlugin フラグを使用してワークスペース コントロールがこのプラグインを認識し、この UI の復元コマンドを実行できるようにする必要があります。

workspaceControlCmd サンプルをビルドするには、「プラグインでの Qt の使用方法」トピックの「プラグインのビルド」セクションを参照してください。プラグインがビルドされたら、プラグインを Maya にロードし、次の MEL スクリプトを実行します。

workspaceControlWindow;