Scripting: Render Tree and ICE Tree Attributes

Render Tree and ICE Tree Attributes

Introduced

v7.0

View attributes for the Render Tree and the ICE Tree. Both views use the same attributes. You can use these attributes when extending the functionality of the Render Tree or ICE Tree via its custom menu hooks.

Not all attributes support both setting and getting. Check the third column in the table.

Note	See ViewAttributes for a complete list of types of attributes that you can use when customizing your Relational Views.

Attribute Name

Description

Supports

container

Returns the full name of the container object (such as the Material or MDTerminalNode) currently displayed in the Render Tree view or ICE Tree. If the Render Tree or ICE Tree is empty it returns an empty string.

Possible Values:	Description:
<name of a scene item>	The SIObject.FullName of the object contained in the Render Tree or ICE Tree.

View.GetAttributeValue only.

refresh

Forces the Render Tree to refresh.

Possible Values:	Description:
<any value>	The value is ignored

View.SetAttributeValue only.

selection

Returns a comma-delimited string containing the full name(s) of the selected nodes currently displayed in the Render Tree or ICE Tree. If nothing is selected it returns an empty string.

Possible Values:	Description:
<node name>	The SIObject.FullName of the selected node(s).

View.GetAttributeValue only.

lock

Controls the lock selection state button in the toolbar.

Possible Values:	Description:
'true'	Locks the selection in the Render Tree or ICE Tree. Note: Use the string "true", not the boolean true.
'false'	Unlocks the selection in the Render Tree or ICE Tree. This means that the Render Tree or ICE Tree display will change when the selection changes. Note: Use the string "false", not the boolean false.

View.GetAttributeValue and View.SetAttributeValue.