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

概要

listAttr( [objects] , [array=boolean], [caching=boolean], [category=string], [changedSinceFileOpen=boolean], [channelBox=boolean], [connectable=boolean], [extension=boolean], [fromPlugin=boolean], [hasData=boolean], [hasNullData=boolean], [inUse=boolean], [keyable=boolean], [leaf=boolean], [locked=boolean], [multi=boolean], [output=boolean], [ramp=boolean], [read=boolean], [readOnly=boolean], [scalar=boolean], [scalarAndArray=boolean], [settable=boolean], [shortNames=boolean], [string=string], [unlocked=boolean], [usedAsFilename=boolean], [userDefined=boolean], [visible=boolean], [write=boolean])

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

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

ノードのアトリビュートがリストされます。フラグを指定しないと、すべてのアトリビュートがリストされます。

戻り値

string[]: 基準に一致するアトリビュートのリスト

関連

addAttr, attributeInfo, attributeQuery, connectAttr, disconnectAttr, getAttr, setAttr

フラグ

array, caching, category, changedSinceFileOpen, channelBox, connectable, extension, fromPlugin, hasData, hasNullData, inUse, keyable, leaf, locked, multi, output, ramp, read, readOnly, scalar, scalarAndArray, settable, shortNames, string, unlocked, usedAsFilename, userDefined, visible, write
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
read(r) boolean create
読み込み可能なアトリビュートのみがリストされます。
write(w) boolean create
書き込み可能なアトリビュートのみがリストされます。
scalar(s) boolean create
スカラー数値アトリビュートのみがリストされます。
array(a) boolean create
配列(マルチ以外)アトリビュートのみがリストされます。
scalarAndArray(sa) boolean create
スカラー アトリビュートと配列アトリビュートのみがリストされます。
visible(v) boolean create
可視アトリビュート、つまり隠れていないアトリビュートのみが表示されます。
connectable(c) boolean create
接続可能アトリビュートのみが表示されます。
category(ct) string createmultiuse
指定したカテゴリに属するアトリビュートのみを表示します。カテゴリの文字列には正規表現を使用できます。
fromPlugin(fp) boolean create
プラグインで作成されたアトリビュートのみを表示します
inUse(iu) boolean create
現在、使用中とマークされたアトリビュートのみを表示します。このフラグは、アトリビュートが何らかの方法でシーン データに作用していることを示します。たとえば、既定以外の値を持つか、別のアトリビュートに接続されています。これは一般的な例であり、実際はそれぞれ異なります。
keyable(k) boolean create
キーフレームにできるアトリビュートのみが表示されます。
channelBox(cb) boolean create
チャネル ボックスに表示されるキー設定不可のアトリビュートだけを表示します。
caching(ca) boolean create
内部的にキャッシュされているアトリビュートのみが表示されます。
extension(ex) boolean create
このタイプのすべてのノードのユーザ定義アトリビュート(拡張子アトリビュート)のリストを表示します。
multi(m) boolean create
マルチアトリビュートの既存の要素がリストされます。
locked(l) boolean create
ロックされているアトリビュートのみがリストされます。
unlocked(u) boolean create
ロックが解除されているアトリビュートのみがリストされます。
userDefined(ud) boolean create
ユーザ定義(ダイナミック)アトリビュートがリストされます。
settable(se) boolean create
設定可能なアトリビュートがリストされます。
shortNames(sn) boolean create
ショート アトリビュート ネームがリストされます。既定ではロング ネームがリストされます。
string(st) string createmultiuse
他の基準に一致し、さらにこのフラグから渡された文字列に一致するアトリビュートのみを表示します。文字列には正規表現を使用できます。
readOnly(ro) boolean create
読み込み可能だが書き込み不可能なアトリビュートのみがリストされます。
output(o) boolean create
数値であるか、数値アトリビュートの複合であるアトリビュートのみがリストされます。
hasData(hd) boolean create
データを持つアトリビュートのみがリストされます(メッセージ アトリビュート以外すべてのアトリビュート)。
hasNullData(hnd) boolean create
ヌル データを持つアトリビュートのみがリストされます。データを持つすべてのアトリビュートがリストされますが(hasData フラグ参照)、データ値は初期化されません。アトリビュートがヌル データを持つ一般的な例として、文字列アトリビュートが作成されたが、初期値がまだ代入されていない場合が挙げられます。同様に、配列型データは初期化されるまでヌルの場合がよくあります。
leaf(lf) boolean create
アトリビュートの名前の末端のみがリストされます。controlPoints[44].xValue ならば、「xValue」とリストされます。
changedSinceFileOpen(cfo) boolean create
アトリビュートの元のファイルが開いてから変更されたアトリビュートのみがリストされます。特に、リファレンス ファイルのオブジェクトやアトリビュートのみに便利です。
ramp(ra) boolean create
ランプであるアトリビュートのみをリスト表示します
usedAsFilename(uf) boolean create
ファイル名として扱われるように指定したアトリビュートのみをリスト表示します

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

Python 例

import maya.cmds as cmds

cmds.sphere()
cmds.listAttr( r=True, s=True )
# This will list the scalar readable attributes of the
# selected nodes.  If more than one node is selected attributes
# may be listed several times.

cmds.listAttr( s=True, r=True, w=True, c=True, st=['centerX','centerY'] )
# This will list all scalar, readable, writable, and connectable
# attributes whose names are "centerX" or "centerY".

cmds.listAttr( r=True, st='center*', ct='a*' )
# This will list all readable attributes whose names match
# "center*" (e.g. "centerX" or "centerpede") and who belong to
# a category starting with the letter "a".

cmds.listAttr( 'nurbsSphere1', s=True, cfo=True )
# This will list all scalar attributes of
# nurbsSphere1 that have been changed since the
# file in which nurbsSphere1 is defined has been
# opened.  If nurbsSphere1 comes from a referenced file,
# the result will be all the attributes that have changed
# since the referenced file was opened.