Parameter.Tags operator

導入

v4.0

詳細

パラメータのタグ(siTags)を戻したり、設定したりします。タグはマーク パラメータと似ていますが、スクリプトやカスタム コマンドによる後処理のためにパラメータにフラグを付ける目的で使用できるという点が異なります。 また、マークパラメータと異なり、タグはシーンとともに保存されます。

タグを使用すると、簡単にクエリしたり整理することができます。また、タグにキーを設定したり、キーをプロットおよび格納したり、スクリプト経由で別のプログラムに変換することができます。1 つのパラメータに対してタグを 1 つから最大 10 個(Tag1、Tag2...)まで設定できます。多くのパラメータを同じタグ値でタグ付けできるため、特定のタグのすべてのパラメータのリストを容易に取得できます。

注:パラメータの現在のタグセットにタグを追加する Tag コマンドとは異なり、このパラメータは元のタグを変更してしまいます。このプロパティを使用してパラメータのタグを設定すると、古いタグが新しいタグに置き換えられます。

ヒント:新しいタグを追加せずにタグを削除するには、siTagNone (0)を使用します。

C#構文

// get accessor

siTags rtn = Parameter.Tags;

// set accessor

Parameter.Tags = siTags;

JScript の例

/*

	This example demonstrates how to manipulate the tags on a parameter

*/

NewScene( null,false );

var oObj = Application.ActiveSceneRoot.AddGeometry( "Cone", "MeshSurface" );

var oParam = oObj.subdivu;

// The parameter shouldn't have any tags, so it should be siTagNone (0)

Application.LogMessage( "The parameter's tags are: " + oParam.Tags );

// Set the siTag2 to the parameter

oParam.Tags = siTag2;

Application.LogMessage( "The parameter's tags are: " + oParam.Tags );

// Set the siTag5 to the parameter, this will remove the siTag2, 

oParam.Tags = siTag5;

Application.LogMessage( "The parameter's tags are: " + oParam.Tags );

// Now set a combination of tags 

oParam.Tags = siTag5 + siTag3 + siTag6;

Application.LogMessage( "The parameter's tags are: " + oParam.Tags );

// Remove all tags

oParam.Tags = siTagNone

Application.LogMessage( "The parameter's tags are: " + oParam.Tags );

// Expected results:

//INFO : The parameter's tags are: 0

//INFO : The parameter's tags are: 2

//INFO : The parameter's tags are: 16

//INFO : The parameter's tags are: 52

//INFO : The parameter's tags are: 0

関連項目

Parameter.IsLocked ProjectItem.TaggedParameters Tag Untag Parameter.Marked