v3.0
Returns or sets the templated user data for this User Data Map as a CustomProperty
(or NULL if there is no template). A User Data Map can be associated with a custom property that
serves as a template for the data inside the User Data Map.
This allows the storage of strongly typed data on each component. The template defines the format
of the data, but the values of the data are stored seperately for each component.
For example a User Data Map on a polygon cluster may have a Template with a integer parameter X
and a floating point parameter Y. This means that each polygon can store its own value of X and Y.
The transfer of data between the associated custom property and individual components can be performed
using UserDataItem.Value and CustomProperty.BinaryData.
// get accessor CustomProperty rtn = UserDataMap.Template; // set accessor UserDataMap.Template = CustomProperty; |
dim oRoot, oObj, oCluster, oPropSet1, oPropSet2, oUserDataMap
'Create all the objects
set oRoot = Application.ActiveProject.ActiveScene.Root
set oObj = oRoot.AddGeometry("Grid","MeshSurface")
set oCluster = oObj.ActivePrimitive.Geometry.AddCluster( siPolygonCluster,"PolyCluster" )
set oPropSet1 = oCluster.AddProperty( "Custom_parameter_list",, "PSet1" )
set oUserDataMap = oCluster.AddProperty( "UserDataMap", false, "DataOnPoints" )
'Add some parameters to the PSet
dim oParam
set oParam = oPropSet1.AddParameter( "Str", siString )
oParam.Value = "Test"
oPropSet1.AddParameter "X", siDouble, , , _
"X short", "X Long", , _
9.87, 0.01, 11.14
oPropSet1.AddParameter "UByte", siUByte, siClassifMetaData , siPersistable, _
, , , _
64, 0, 128
set oUserDataMap.Template = oPropSet1
'Change a parameter value via the User Data Map
set oParam = oUserDataMap.Template.Parameters( "X" )
oParam.Value = 3.23
'So far none of the polygons actually have any user data stored on them.
'We can save the current values of the template custom property onto polygon 5
'using the following:
oUserDataMap.Item( 5 ).Value = oUserDataMap.Template.BinaryData
'Change our minds and remove the association. (This doesn't
'erase the user data we stored on polygon 5)
set oUserDataMap.Template = Nothing |