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

概要

fileDialog2([buttonBoxOrientation=int], [cancelCaption=string], [caption=string], [dialogStyle=int], [fileFilter=string], [fileMode=int], [fileTypeChanged=script], [hideNameEdit=boolean], [okCaption=string], [optionsUICancel=script], [optionsUICommit=script], [optionsUICommit2=script], [optionsUICreate=script], [optionsUIInit=script], [optionsUITitle=string], [returnFilter=boolean], [selectFileFilter=string], [selectionChanged=script], [setProjectBtnEnabled=boolean], [startingDirectory=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

ファイルまたはディレクトリを選択できるダイアログが設定されます。

戻り値

string配列

フラグ

buttonBoxOrientation, cancelCaption, caption, dialogStyle, fileFilter, fileMode, fileTypeChanged, hideNameEdit, okCaption, optionsUICancel, optionsUICommit, optionsUICommit2, optionsUICreate, optionsUIInit, optionsUITitle, returnFilter, selectFileFilter, selectionChanged, setProjectBtnEnabled, startingDirectory
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
buttonBoxOrientation(bbo) int create
  • 1 垂直なボタン ボックス レイアウト。[キャンセル(Cancel)]ボタンは[適用(Accept)]ボタンの下にあります。
  • 2 水平なボタン ボックス レイアウト。[キャンセル(Cancel)]ボタンは[適用(Accept)]ボタンの右にあります。
cancelCaption(cc) string create
dialogStyle フラグを 2 に設定すると、ダイアログの[キャンセル(Cancel)]ボタンにキャプションが表示されます。
caption(cap) string create
ダイアログのタイトルを設定します。
dialogStyle(ds) int create
  • 1 は Windows または Mac OS X では、一般的なスタイルのファイル ダイアログが使用されます。
  • 2 はプラットフォーム間で一致したスタイルのカスタム ファイル ダイアログが使用されます。
fileFilter(ff) string create
ダイアログのファイル タイプ フィルタのリストを設定します。複数フィルタの場合は、二重のセミコロンで分離する必要があります。例を参照してください。
fileMode(fm) int create
ダイアログが返す内容を示します。
  • 0 は任意のファイルが存在するかどうか。
  • 1 は 1 つの既存ファイル。
  • 2 はディレクトリ名。ディレクトリとファイルの両方がダイアログに表示されます。
  • 3 はディレクトリ名。ディレクトリのみがダイアログに表示されます。
  • 4 は 1 つ以上の既存ファイル名。
fileTypeChanged(ftc) script create
MEL のみ。文字列は MEL コールバックとして解釈され、ユーザが選択したファイル タイプの変更時にコールされます。コールバックの形式は次のとおりです。

global proc MyCustomFileTypeChanged(string $parent, string $newType)

親引数は、optionsUICreate フラグを使用してコントロールが追加された親レイアウトです。newType 引数は新しいファイル タイプです。

hideNameEdit(hne) boolean create
名前編集入力フィールドを非表示にします。
okCaption(okc) string create
dialogStyle フラグを 2 に設定すると、ダイアログの[OK]または[適用(Accept)]ボタンにキャプションが表示されます。
optionsUICancel(oca) script create
MEL のみ。文字列は、ダイアログがキャンセルされた([キャンセル(Cancel)]ボタンまたは[閉じる(Close)]ボタンを使用してウィンドウを閉じた)ときにコールされる MEL コールバックとして解釈されます。コールバックの形式は次のとおりです。

global proc MyCustomOptionsUICancel()

optionsUICommit(ocm) script create
MEL のみ。文字列は MEL コールバックとして解釈され、ダイアログの却下に成功するとコールされます。ユーザがダイアログをキャンセルした場合、またはウィンドウ タイトル バーのコントロールかその他のウィンドウ システムの手段を使用してウィンドウを閉じた場合は、コールされません。コールバックの形式は次のとおりです。

global proc MyCustomOptionsUICommit(string $parent)

親引数は、optionsUICreate フラグを使用してコントロールが追加された親レイアウトです。

optionsUICommit2(oc2) script create
MEL のみ。optionsUICommit として指定された文字列は MEL コールバックとして解釈され、ダイアログの却下に成功するとコールされます。違いは、このコールバックがダイアログの検証前にユーザによって選択されたファイル名を追加引数として 1 つ取ることです。ユーザがダイアログをキャンセルした場合、またはウィンドウ タイトル バーのコントロールかその他のウィンドウ システムの手段を使用してウィンドウを閉じた場合は、コールされません。コールバックの形式は次のとおりです。

global proc MyCustomOptionsUICommit(string $parent, string $selectedFile)

親引数は、optionsUICreate フラグを使用してコントロールが追加された親レイアウトです。

optionsUICreate(ocr) script create
MEL のみ。文字列は MEL コールバックとして解釈され、ファイル ダイアログの作成時にコールされます。コールバックの形式は次のとおりです。

global proc MyCustomOptionsUISetup(string $parent)

親引数は、コントロールを追加できる親レイアウトです。この親は、ファイル ダイアログの右手のペインです。

optionsUIInit(oin) script create
MEL のみ。文字列は MEL コールバックとして解釈され、コントロールを初期化するためにファイル ダイアログの作成直後にコールされます。コールバックの形式は次のとおりです。

global proc MyCustomOptionsUIInitValues(string $parent, string $filterType)

親引数は、optionsUICreate フラグを使用してコントロールが追加された親レイアウトです。filterType 引数は初期ファイル フィルタです。

optionsUITitle(oti) string create
MEL のみ。optionsUICreate が設定されている場合は、このフラグを使用してオプション ウィンドウにカスタム タイトルを設定できます。タイトルが必要ない場合は、空白の文字列("" など)を使用できます。
returnFilter(rf) boolean create
true の場合、選択したフィルタは選択したファイルとともに、文字配列の最後の項目として返されます。
selectFileFilter(sff) string create
初期ファイル フィルタを、選択するように指定します。ワイルドカード仕様全体ではなく、開始テキストのみを指定します。
selectionChanged(sc) script create
MEL のみ。文字列は MEL コールバックとして解釈され、ユーザがファイル ダイアログでファイルの選択を変更したときにコールされます。コールバックの形式は次のとおりです。

global proc MyCustomSelectionChanged(string $parent, string $selection)

親引数は、optionsUICreate フラグを使用してコントロールが追加された親レイアウトです。selection 引数は新たに選択されたファイルへのフル パスです。

setProjectBtnEnabled(spe) boolean create
[プロジェクト]ボタンを有効にするかどうかを定義します。
startingDirectory(dir) string create
ダイアログの開始ディレクトリを設定します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

import maya.cmds as cmds

basicFilter = "*.mb"
cmds.fileDialog2(fileFilter=basicFilter, dialogStyle=2)

singleFilter = "All Files (*.*)"
cmds.fileDialog2(fileFilter=singleFilter, dialogStyle=2)

multipleFilters = "Maya Files (*.ma *.mb);;Maya ASCII (*.ma);;Maya Binary (*.mb);;All Files (*.*)"
cmds.fileDialog2(fileFilter=multipleFilters, dialogStyle=2)