textFieldGrp

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

概要

textFieldGrp( [groupName] , [adjustableColumn=int], [adjustableColumn2=int], [adjustableColumn3=int], [adjustableColumn4=int], [adjustableColumn5=int], [adjustableColumn6=int], [annotation=string], [backgroundColor=[float, float, float]], [changeCommand=script], [columnAlign=[int, string]], [columnAlign2=[string, string]], [columnAlign3=[string, string, string]], [columnAlign4=[string, string, string, string]], [columnAlign5=[string, string, string, string, string]], [columnAlign6=[string, string, string, string, string, string]], [columnAttach=[int, string, int]], [columnAttach2=[string, string]], [columnAttach3=[string, string, string]], [columnAttach4=[string, string, string, string]], [columnAttach5=[string, string, string, string, string]], [columnAttach6=[string, string, string, string, string, string]], [columnOffset2=[int, int]], [columnOffset3=[int, int, int]], [columnOffset4=[int, int, int, int]], [columnOffset5=[int, int, int, int, int]], [columnOffset6=[int, int, int, int, int, int]], [columnWidth=[int, int]], [columnWidth1=int], [columnWidth2=[int, int]], [columnWidth3=[int, int, int]], [columnWidth4=[int, int, int, int]], [columnWidth5=[int, int, int, int, int]], [columnWidth6=[int, int, int, int, int, int]], [defineTemplate=string], [docTag=string], [dragCallback=script], [dropCallback=script], [editable=boolean], [enable=boolean], [enableBackground=boolean], [exists=boolean], [fileName=string], [forceChangeCommand=boolean], [fullPathName=string], [height=int], [insertText=string], [insertionPosition=int], [isObscured=boolean], [label=string], [manage=boolean], [noBackground=boolean], [numberOfPopupMenus=boolean], [parent=string], [placeholderText=string], [popupMenuArray=boolean], [preventOverride=boolean], [rowAttach=[int, string, int]], [text=string], [textChangedCommand=script], [useTemplate=string], [visible=boolean], [visibleChangeCommand=script], [width=int])

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

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

どのグループ コマンドを使用しても、カラム 1 から始まるカラムに個々のコントロールが配置されます。各コントロール（カラム）のレイアウトは、-cw/columnWidth、-co/columnOffset、-cat/columnAttach、-cal/columnAlign、-adj/adjustableColumn の各フラグを使用してカスタマイズできます。既定では、カラムはオフセットなしで左に揃えられ、幅は 100 ピクセルです。どのグループでも、1 つのカラムだけが調整できます。

あらかじめパッケージ化されたラベル テキストの集合体と、編集可能なテキスト フィールドを作成するコマンドです。ラベル テキストはオプションです。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
exists(ex)	boolean
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
useTemplate(ut)	string
コマンドに、現在以外のコマンド テンプレートの使用を強制します。
parent(p)	string
コントロールの親のレイアウトです。
enable(en)	boolean
コントロールの有効、無効です。既定では true に設定されていて、コントロールは有効になっています。false を指定するとコントロールはグレー表示になって無効になります。
width(w)	int
コントロールの幅を指定します。コントロールは親のレイアウトの条件によって無効にされない限り、このサイズを保持しようとします。
height(h)	int
コントロールの高さです。コントロールは親のレイアウトの条件によって無効にされない限り、このサイズを保持しようとします。
visible(vis)	boolean
コントロールの可視の状態です。既定では、コントロールは表示されます。コントロールの実際の外見も、その親レイアウトの可視の状態によって異なることに注意してください。
visibleChangeCommand(vcc)	script
コントロールの可視の状態が変更されたときに実行されるコマンドです。
isObscured(io)	boolean
コントロールが実際に表示されるかどうかを返します。コントロールは、次の場合に隠れた状態になります。非表示の場合、別のコントロールで(完全に、または部分的に)ブロックされた場合、コントロールまたは親のレイアウトを制御できない場合、あるいはコントロールのウィンドウが非表示またはアイコン化されている場合。
manage(m)	boolean
コントロールの状態を管理します。管理されていないコントロールは表示されず、画面の領域も占有しません。既定では、コントロールは管理できるように作成されます。
numberOfPopupMenus(npm)	boolean
このコントロールにアタッチされるポップアップ メニューの数を返します。
popupMenuArray(pma)	boolean
このコントロールにアタッチされる全ポップアップ メニューの名前を返します。
preventOverride(po)	boolean
true の場合、コントロールのコントロールは親のレイアウトの条件によって無効にされ右マウス ボタン メニューを使用したコントロール アトリビュートのオーバーライドは無効です。
annotation(ann)	string
コントロールに文字列値で注釈を付けます。
backgroundColor(bgc)	[float, float, float]
コントロールのバックグラウンド カラーです。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0～1.0 です。 backgroundColor を設定する場合、enableBackground を false に指定していない限り、バックグラウンドは自動的に有効になります。
noBackground(nbg)	boolean
コントロールのバックグラウンドをクリア/リセットします。バックグラウンドは、true を渡すと一切描画されず、false を渡すと描画されます。このフラグの状態は、このコントロールの子に継承されます。
enableBackground(ebg)	boolean
コントロールのバックグラウンド カラーを有効にします。
docTag(dtg)	string
コントロールにドキュメンテーション フラグを追加します。ドキュメンテーション フラグは、階層のようなディレクトリ構造になっています。例: -dt render/multiLister/createNode/material
dragCallback(dgc)	script
中マウス ボタンを押すとコールされるコールバックを追加します。MEL バージョンのコールバックの書式は次のとおりです。 global proc string[] callbackName(string $dragControl, int $x, int $y, int $mods) proc はドロップ先に転送される文字配列を返します。規則により、配列の先頭文字列はユーザ設定可能なメッセージ タイプを表しています。アプリケーションで定義されたドラッグ元のコントロールは、このコールバックを無視する可能性があります。$mods で、キー モディファイアである CTL と SHIFT をテストできます。有効な値は、0 == モディファイアなし、1 == SHIFT、2 == CTL、3 == CTL + SHIFT です。 Python でも同様ですが、コールバックの指定方法が 2 つあります。お勧めの方法は、引数として Python 関数オブジェクトを渡すことです。この場合、Python コールバックの書式は次のようになります。 def callbackName( dragControl, x, y, modifiers ): この引数の値は、上記の MEL バージョンの引数と同じです。 Python でコールバックを指定するもう 1 つの方法では、実行する文字列を指定します。この場合、Python の標準的なフォーマット演算子を介して文字列に値が代入されます。このフォーマットの値は、キー「dragControl」、「x」、「y」、「modifiers」と共に辞書で渡されます。dragControl の値は文字列で、その他の値は整数です(コールバック文字列の例: 「print '%(dragControl)s %(x)d %(y)d %(modifiers)d'」)。
dropCallback(dpc)	script
ドラッグ＆ドロップ操作をドロップ位置で解放したときにコールされるコールバックを追加します。MEL バージョンのコールバックの書式は次のとおりです。 global proc callbackName(string $dragControl, string $dropControl, string $msgs[], int $x, int $y, int $type) proc は、ドラッグ元から転送される文字配列を受け取ります。msgs 配列の先頭文字列はユーザ定義のメッセージ タイプを表します。アプリケーションで定義されたドロップ先のコントロールでは、このコールバックが無視されることがあります。$type の値は、1 == 移動、2 == コピー、3 == リンクのいずれかです。 Python でも同様ですが、コールバックの指定方法が 2 つあります。お勧めの方法は、引数として Python 関数オブジェクトを渡すことです。この場合、Python コールバックの書式は次のようになります。 def pythonDropTest( dragControl, dropControl, messages, x, y, dragType ): この引数の値は、上記の MEL バージョンの引数と同じです。 Python でコールバックを指定するもう 1 つの方法では、実行する文字列を指定します。この場合、Python の標準的なフォーマット演算子を介して文字列に値が代入されます。このフォーマットの値は、キー「dragControl」、「dropControl」、「messages」、「x」、「y」、「type」と共に辞書で渡されます。dragControl の値は文字列で、その他の値は整数です(コールバック文字列の例: 「print '%(dragControl)s %(dropControl)s %(messages)r %(x)d %(y)d %(type)d'」)。
fullPathName(fpn)	string
すべての親を含むウィジェットのフル パス名を返します。
columnWidth(cw)	[int, int]
引数は、カラム番号、カラム幅です。指定したカラムの幅を設定します。ここで、最初のパラメータがカラム(インデックスは 1 から始まる)を指定し、2 つめのパラメータが幅を指定します。
columnWidth1(cw1)	int
第 1 カラムの幅を設定します。カラムがちょうど 1 つではない場合は、無視されます。
columnWidth2(cw2)	[int, int]
2 つのカラムの幅を設定します。カラムがちょうど 2 つではない場合は、無視されます。
columnWidth3(cw3)	[int, int, int]
3 つのカラムすべての幅を設定します。カラムがちょうど 3 つではない場合は、無視されます。
columnWidth4(cw4)	[int, int, int, int]
4 つのカラムすべての幅を設定します。カラムがちょうど 4 つではない場合は、無視されます。
columnWidth5(cw5)	[int, int, int, int, int]
5 つのカラムすべての幅を設定します。カラムがちょうど 5 つではない場合は、無視されます。
columnWidth6(cw6)	[int, int, int, int, int, int]
6 つのカラムすべての幅を設定します。カラムがちょうど 6 つではない場合は、無視されます。
columnAttach(cat)	[int, string, int]
引数は、カラム番号、アタッチメント タイプ、オフセットです。指定可能なアタッチメントは、「left」、「right」、または「both」です。カラムのアタッチメント タイプとオフセットを指定します。
columnAttach2(ct2)	[string, string]
2 つのカラムのアタッチメント タイプを設定します。カラムがちょうど 2 つではない場合は、無視されます。有効な値は「left」、「right」、「both」です。
columnAttach3(ct3)	[string, string, string]
3 つのカラムすべてのアタッチメント タイプを設定します。カラムがちょうど 3 つではない場合は、無視されます。有効な値は「left」、「right」、「both」です。
columnAttach4(ct4)	[string, string, string, string]
4 つのカラムすべてのアタッチメント タイプを設定します。カラムがちょうど 4 つではない場合は、無視されます。有効な値は「left」、「right」、「both」です。
columnAttach5(ct5)	[string, string, string, string, string]
5 つのカラムすべてのアタッチメント タイプを設定します。カラムがちょうど 5 つではない場合は、無視されます。有効な値は「left」、「right」、「both」です。
columnAttach6(ct6)	[string, string, string, string, string, string]
6 つのカラムすべてのアタッチメント タイプを設定します。カラムがちょうど 6 つではない場合は、無視されます。有効な値は「left」、「right」、「both」です。
columnOffset2(co2)	[int, int]
このフラグは -columnAttach2 フラグと一緒に使用します。そのフラグと一緒に使用しない場合、このフラグは無視されます。2 つのカラムのオフセットを設定します。適用されるオフセットは、-columnAttach2 フラグで指定したアタッチメントに基づいています。カラムがちょうど 2 つではない場合は、無視されます。
columnOffset3(co3)	[int, int, int]
このフラグは -columnAttach3 フラグと一緒に使用します。そのフラグと一緒に使用しない場合、このフラグは無視されます。3 つのカラムのオフセットを設定します。適用されるオフセットは、-columnAttach3 フラグで指定したアタッチメントに基づいています。カラムがちょうど 3 つではない場合は、無視されます。
columnOffset4(co4)	[int, int, int, int]
このフラグは -columnAttach4 フラグと一緒に使用します。そのフラグと一緒に使用しない場合、このフラグは無視されます。4 つのカラムのオフセットを設定します。適用されるオフセットは、-columnAttach4 フラグで指定したアタッチメントに基づいています。カラムがちょうど 4 つではない場合は、無視されます。
columnOffset5(co5)	[int, int, int, int, int]
このフラグは -columnAttach5 フラグと一緒に使用します。そのフラグと一緒に使用しない場合、このフラグは無視されます。5 つのカラムのオフセットを設定します。適用されるオフセットは、-columnAttach5 フラグで指定したアタッチメントに基づいています。カラムがちょうど 5 つではない場合は、無視されます。
columnOffset6(co6)	[int, int, int, int, int, int]
このフラグは -columnAttach6 フラグと一緒に使用します。そのフラグと一緒に使用しない場合、このフラグは無視されます。6 つのカラムのオフセットを設定します。適用されるオフセットは、-columnAttach6 フラグで指定したアタッチメントに基づいています。カラムがちょうど 6 つではない場合は、無視されます。
rowAttach(rat)	[int, string, int]
引数は、カラム、アタッチメント タイプ、オフセットです。指定可能なアタッチメントは、「top」、「bottom」、または「both」です。行全体のアタッチメント タイプとオフセットを指定します。
columnAlign(cal)	[int, string]
引数は、カラム番号、位置合わせタイプです。指定可能な位置合わせは、「left」、「right」、または「center」です。指定したカラムの位置合わせタイプを設定します。
columnAlign2(cl2)	[string, string]
2 つのカラムのテキスト位置合わせを設定します。カラムがちょうど 2 つではない場合は、無視されます。有効な値は「left」、「right」、「center」です。
columnAlign3(cl3)	[string, string, string]
3 つのカラムすべてのテキスト位置合わせを設定します。カラムがちょうど 3 つではない場合は、無視されます。有効な値は「left」、「right」、「center」です。
columnAlign4(cl4)	[string, string, string, string]
4 つのカラムすべてのテキスト位置合わせを設定します。カラムがちょうど 4 つではない場合は、無視されます。有効な値は「left」、「right」、「center」です。
columnAlign5(cl5)	[string, string, string, string, string]
5 つのカラムすべてのテキスト位置合わせを設定します。カラムがちょうど 5 つではない場合は、無視されます。有効な値は「left」、「right」、「center」です。
columnAlign6(cl6)	[string, string, string, string, string, string]
6 つのカラムすべてのテキスト位置合わせを設定します。カラムがちょうど 6 つではない場合は、無視されます。有効な値は「left」、「right」、「center」です。
adjustableColumn(adj)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムの値は 1 から始まるインデックスです。0 を指定して、以前はサイズ調整可能であったカラムをオフに切り替えることもできます。
adjustableColumn2(ad2)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムがちょうど 2 つではない場合は、無視されます。
adjustableColumn3(ad3)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムがちょうど 3 つではない場合は、無視されます。
adjustableColumn4(ad4)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムがちょうど 4 つではない場合は、無視されます。
adjustableColumn5(ad5)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムがちょうど 5 つではない場合は、無視されます。
adjustableColumn6(ad6)	int
親のレイアウトのサイズ変更に従ってサイズを変化させるカラムを指定します。カラムがちょうど 6 つではない場合は、無視されます。
label(l)	string
グループ用のラベル テキストです。
text(tx)	string
フィールド内のテキストです。
placeholderText(pht)	string
このプロパティを設定すると、テキスト フィールドが空でウィジェットにフォーカスがない限り、ライン編集にはグレー表示のプレースホルダ テキストが表示されます。このプロパティには既定で空の文字列が含まれます。
fileName(fi)	string
ファイル名としてフィールドにあるテキストです。これは、内部と外部の間で(UI)ファイル表現を変換します。
insertText(it)	string
現在の挿入位置で、フィールドにテキストを挿入します(-ip/insertionPosition flag で指定します)。
insertionPosition(ip)	int
挿入テキストの挿入位置です。これは 1 をベースにした値です。つまり、位置 1 はフィールドの先頭を示します。位置 0 を使用してフィールドの最後を指定することもできます。
forceChangeCommand(fcc)	boolean
-text や -inserText フラグとともに使用した場合、テキスト修正後に change コマンドが実行されます。
editable(ed)	boolean
フィールドの編集状態です。既定では、このフラグは true に設定され、これに入力することでフィールド値を変更することができます。false の場合は、フィールドは「読み取り専用」になるので、フィールドに入力することはできません。フィールドのテキストは、-ed/editable フラグの状態にかかわらず、常に -tx/text フラグを使用して変更できます。
changeCommand(cc)	script
フィールド テキストを変更し、ユーザが[Enter]または[Return]を押したときに実行されるコマンドです。
textChangedCommand(tcc)	script
フィールド テキストを変更するとただちに実行されるコマンドです。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

cmds.window()
cmds.columnLayout()
cmds.textFieldGrp( label='Group 1', text='Editable' )
cmds.textFieldGrp( label='Group 2', text='Non-editable', editable=False )
cmds.showWindow()