confirmDialog コマンド

概要

confirmDialog([backgroundColor=[float, float, float]], [button=string], [cancelButton=string], [defaultButton=string], [dismissString=string], [message=string], [messageAlign=string], [parent=string], [title=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

confirmDialog コマンドは、ユーザに対するメッセージを含むモーダルダイアログと、そのダイアログを却下するための変数のボタンを作成します。このダイアログは、何かボタンを押したとき、またはウィンドウメニューから「閉じる」を選ぶと却下されます。ボタンを押した場合は、選択したボタンの名前が返されます。「閉じる」を選んでダイアログを閉じた場合に返される文字列は、dismissString フラグで指定されます。

引数が指定されていない場合のデフォルト動作は、空の単一のボタンダイアログを作成するように指定されています。

戻り値

string

ダイアログを却下する方法を示します。ボタンを押すと、ボタンのラベルが返されます。ダイアログを閉じると、フラグ dismissString の値が返されます。

フラグ

backgroundColor, button, cancelButton, defaultButton, dismissString, message, messageAlign, parent, title

ロングネーム（ショートネーム） 引数型 プロパティ

title(t) string

ダイアログのタイトルです。

message(m) string

ダイアログに表示されるメッセージテキストです。

messageAlign(ma) string

メッセージを左、中央、または右にアラインします。

button(b) string

指定した文字列がテキストとして表示されるボタンを作成します。

defaultButton(db) string

Enter キーを押すとデフォルトボタンがアクティブになります。このフラグはボタンを作成するのではなく、button フラグで作成されたボタンのうちどれを Enter キーに対応させるかを指定するだけであることに注意してください。

cancelButton(cb) string

Escape キーを押すと取り消しボタンがアクティブになります。このフラグはボタンを作成するのではなく、button フラグで作成されたボタンのうちどれを Esc キーに対応させるかを指定するだけであることに注意してください。

dismissString(ds) string

ユーザが Window Manager メニューから「閉じる」を選択すると返される文字列です。このフラグが設定されていない場合は、文字列「dismiss」が返されます。

parent(p) string

ダイアログの親ウィンドウを指定します。ダイアログは親ウィンドウの中央に配置され、親ウィンドウの動きにつれて上下します。デフォルトでは、ダイアログは特定のウィンドウにはペアレント化されておらず、画面の中央に配置されます。

backgroundColor(bgc) [float, float, float]

ダイアログのバックグラウンドカラーです。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0～1.0 です（Windows のみのフラグです）。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# Create an empty single button dialog.
#
# +-+----------------+
# |-| Confirm Dialog |
# +------------------+
# |                  |
# +------------------+
# | +--------------+ |
# | |   Confirm    | |
# | +--------------+ |
# +------------------+
#
cmds.confirmDialog()

# Create a basic Yes/No dialog.
#
# +-+----------------+
# |-|    Confirm     |
# +------------------+
# |  Are you sure?   |
# +------------------+
# | +-----+  +-----+ |
# | | Yes |  | No  | |
# | +-----+  +-----+ |
# +------------------+
#
cmds.confirmDialog( title='Confirm', message='Are you sure?', button=['Yes','No'], defaultButton='Yes', cancelButton='No', dismissString='No' )

コマンド (Python)	MEL バージョン
confirmDialog	カテゴリ: ウィンドウ