Parameter.Tags operator

導入

v4.0

詳細

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

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

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

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

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