Clip.AddProperty

導入

v4.0

詳細

UserDataBlobまたはCustomPropertyを作成し、Clip オブジェクトに追加します。

スクリプト 構文

oReturn = Clip.AddProperty( Preset, [BranchFlag], [Name] );

戻り値

CustomPropertyUserDataBlobUserDataMapまたは(使用されたプリセットによる)

パラメータ

パラメータ タイプ 詳細
プリセット String この引数には、Property Preset の名前またはファイル名やプリセット ファイルへの完全パスを含む文字列が格納されます。

注意: クリップには CustomProperty PresetsUserDataBlob Presets、および UserDataMap Presets のみが有効です。

作成されるプロパティのタイプはこの引数により決定されます。たとえば、"CustomProperty" は空のCustomPropertyを作成し、"UserDataBlob" はUserDataBlobを作成します。
BranchFlag Boolean False は、唯一のサポートされる値です。

デフォルト値: false

Name String 新しいプロパティの名前を表します(SIObject.Nameを参照)。指定しない場合には、オブジェクトは Preset 引数に基づいて名前が付けられます。

JScript の例

NewScene( null,false ) ;
var oRoot = ActiveProject.ActiveScene.Root ;
var oGrid = oRoot.AddGeometry( "Grid", "MeshSurface" );
var oGeom = oGrid.ActivePrimitive.Geometry ;
var oClip = oGeom.SaveShapeKey(1) ;
var oPSet = oClip.AddProperty( "CustomProperty",false,"ClipData" ) ;
oPSet.AddParameter3( "StringOnClip", siString ) ;
//You can also store binary data
oClip.AddProperty( "UserDataBlob",false,"MyBlob" ) ;
//The new properties show up on the bottom
//of the PPG
InspectObj( oClip ) ;

関連項目

SceneItem.AddProperty Clip.Properties