pymel.core.general.attributeQuery

static general.attributeQuery(*args, **kwargs)

attributeQuery returns information about the configuration of an attribute. It handles both boolean flags, returning true or false, as well as other return values. Specifying more than one boolean flag will return the logical andof all the specified boolean flags. You may not specify any two flags when both do not provide a boolean return type. (eg. -internal -hiddenis okay but -range -hiddenor -range -softRangeis not.)

Flags:

Long name (short name)		Argument Types	Properties
connectable (c)		bool
	Return the connectable status of the attribute
enum (e)		bool
	Return true if the attribute is a enum attribute
exists (ex)		bool
	Return true if the attribute exists
hidden (h)		bool
	Return the hidden status of the attribute
indexMatters (im)		bool
	Return the indexMatters status of the attribute
internal (i)		bool
	Return true if the attribute is either internalSet or internalGet
internalGet (ig)		bool
	Return true if the attribute come from getCachedValue
internalSet (internalSet)		bool
	Return true if the attribute must be set through setCachedValue
keyable (k)		bool
	Return the keyable status of the attribute
listChildren (lc)		bool
	Return the list of children attributes of the given attribute.
listDefault (ld)		bool
	Return the default values of numeric and compound numeric attributes.
listEnum (le)		bool
	Return the list of enum strings for the given attribute.
listParent (lp)		bool
	Return the parent of the given attribute.
listSiblings (ls)		bool
	Return the list of sibling attributes of the given attribute.
longName (ln)		bool
	Return the long name of the attribute.
maxExists (mxe)		bool
	Return true if the attribute has a hard maximum. A min does not have to be present.
maximum (max)		bool
	Return the hard maximum of the attribute’s value
message (msg)		bool
	Return true if the attribute is a message attribute
minExists (mne)		bool
	Return true if the attribute has a hard minimum. A max does not have to be present.
minimum (min)		bool
	Return the hard minimum of the attribute’s value
multi (m)		bool
	Return true if the attribute is a multi-attribute
niceName (nn)		bool
	Return the nice name (or UI name) of the attribute. Flag can have multiple arguments, passed either as a tuple or a list.
node (n)		PyNode
	Use all attributes from node named NAME
numberOfChildren (nc)		bool
	Return the number of children the attribute has
range (r)		bool
	Return the hard range of the attribute’s value
rangeExists (re)		bool
	Return true if the attribute has a hard range. Both min and max must be present.
readable (rd)		bool
	Return the readable status of the attribute
shortName (sn)		bool
	Return the short name of the attribute.
softMax (smx)		bool
	Return the soft max (slider range) of the attribute’s value
softMaxExists (sxe)		bool
	Return true if the attribute has a soft maximum. A min does not have to be present.
softMin (smn)		bool
	Return the soft min (slider range) of the attribute’s value
softMinExists (sme)		bool
	Return true if the attribute has a soft minimum. A max does not have to be present.
softRange (s)		bool
	Return the soft range (slider range) of the attribute’s value
softRangeExists (se)		bool
	Return true if the attribute has a soft range. Both min and max must be present.
storable (st)		bool
	Return true if the attribute is storable
type (typ)		unicode
	Use static attributes from nodes of type TYPE. Includes attributes inherited from parent class nodes.
typeExact (tex)		unicode
	Use static attributes only from nodes of type TYPE. Does not included inherited attributes.
usedAsColor (uac)		bool
	Return true if the attribute should bring up a color picker
writable (w)		bool
	Return the writable status of the attribute

Derived from mel command maya.cmds.attributeQuery

Example:

import pymel.core as pm

# Determine the hidden status of the "selector" attribute on choice nodes.
#
pm.attributeQuery( 'selector', typ='choice', h=True )
# Result: False #
# Result: 0
# Determine the hidden status of the "selector" attribute on this choice node.
# (Usually the same but you can do this for dynamic attributes too.)
#
pm.createNode( 'choice', n='whoIsIt' )
# Result: nt.Choice(u'whoIsIt') #
# Result: choice1
pm.attributeQuery( 'selector', n='whoIsIt', h=True )
# Result: False #
# Result: 0
# Determine the range of the selector value on choice nodes.
# In this case there is no range.
# Note, if there is only a minimum or only a maximum range will not set.
#
pm.attributeQuery( 'selector', typ='choice', range=True )
# For the next several examples create a poly cube and add extra attributes.
pm.polyCube( cuv=4, ch=1, w=1, h=1, d=1, sx=1, sy=1, sz=1, ax=(0, 1, 0) )
pm.addAttr( '|pCube1', ln='egRange', at='long', min=0, max=5, dv=2 )
pm.setAttr( '|pCube1.egRange', e=True, keyable=False )
# Determine if an attribute is keyable
#
pm.attributeQuery( 'egRange', node='pCube1', k=True )
# Result: 0
# Determine the minimum and maximum values of the added attribute egRange
#
pm.attributeQuery( 'egRange', node='pCube1', range=True )
# Result: [0.0, 5.0]
# Determine if there is a minimum for the attribute.
# Note, having a minimum or maximum value does not imply the attribute has a range.
pm.addAttr( '|pCube1', ln='egMin', at='long', min=2 )
pm.attributeQuery( 'egMin', node='pCube1', minExists=True )
# Result: 1
pm.attributeQuery( 'egMin', node='pCube1', maxExists=True )
# Result: 0
pm.attributeQuery( 'egMin', node='pCube1', min=True )
# Result: [2.0]
# Determine if an attribute is an enum
# List the enum strings. This will use ':' as a separator like the attr is written in
# an .ma file.
pm.addAttr( '|pCube1', ln='myEnum', at='enum', en='chicken:turkey:duck:' )
pm.attributeQuery( 'myEnum', node='pCube1', listEnum=True )
[u'chicken:turkey:duck']