ジャンプ先: 概要. 戻り値. キーワード. 関連項目. フラグ. Python 例.

概要

deleteExtension([attribute=string], [forceDelete=boolean], [nodeType=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

deleteExtension は 「元に戻す」が不可能、「照会」が不可能、「編集」が不可能 です。

このコマンドは、ノード タイプから拡張子アトリビュートを削除するのに使用されます。 アトリビュートは、ロング ネームかショート ネームのどちらかを使用して指定できます。 一度に削除できる拡張子アトリビュートは 1 つだけです。複合アトリビュートの子は削除できません。 その場合、複合アトリビュート全体を削除する必要があります。 このコマンドには元に戻す機能、編集機能、照会機能はありません。

戻り値

int 削除後にデータを変更したノードの数

キーワード

attribute, dependency, graph, delete, extension

関連項目

addAttr, addExtension, aliasAttr, attributeInfo, connectAttr, deleteAttr, disconnectAttr, getAttr, getClassification, nodeType, objExists, objectType, renameAttr, setAttr

フラグ

attribute, forceDelete, nodeType
ロング ネーム（ショート ネーム） 引数型 プロパティ
nodeType(nt) string create
ノード タイプの名前。
attribute(at) string create
アトリビュートのロング ネームかショート ネームを指定します。
forceDelete(fd) boolean create
このフラグを設定してオンにすると、拡張子アトリビュートのすべてのデータ値が確認なしで削除されます。 設定してオフにすると、ノードのデフォルト以外の値を設定した拡張子アトリビュートはそのまま保持されます。 このフラグを設定しない場合、拡張子アトリビュートのデフォルト以外の値を保持するかどうかが確認されます。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

cmds.addExtension( nodeType='planet', longName='martians', shortName='mr', attributeType='double' )
cmds.createNode( 'planet', name='jupiter' )
cmds.createNode( 'planet', name='mars' )
cmds.setAttr( 'mars.mr', 35 )
# Delete an extension attribute named mr/martians.
# Only returns 1 since the planet node 'jupiter'
# does not have a non-default value on the extension.
cmds.deleteExtension( nodeType='planet', forceDelete=True, attribute='martians' )
# Return: 1 //
# The attribute is gone since it was forced out
cmds.attributeQuery( type='planet', attribute='mr', query=True, exists=True )
# Return: 0 //
# Re-add and delete the extension again, forcing the
# attribute to remain if non-default values exist.
cmds.addExtension( nodeType='planet', longName='martians', shortName='mr', attributeType='double' )
cmds.setAttr( 'mars.mr', 35 )
cmds.deleteExtension( nodeType='planet', forceDelete=False, attribute='mr' )
# Return: 0 //
# The attribute still exists since it had some non-default values
cmds.attributeQuery( type='planet', attribute='mr', query=True, exists=True )
# Return: 1 //
cmds.attributeQuery( name='jupiter', attribute='mr', query=True, exists=True )
# Return: 1 //