## UserDataItem

Object Hierarchy

### Introduced

v3.0

### Description

The UserDataItem object represents a single instance of user data that has been attached to a Softimage component. For example, each polygon on a Cluster with a UserDataMap will have its own instance of this UserDataItem object.
This object is provided for convenience but it is also possible to manipulate the user data using the methods UserDataMap.ItemValue, UserDataMap.ItemSize and UserDataMap.IsEmpty provided directly on the UserDataMap.

### Properties

IsEmpty | Size | Value |

### Examples

#### VBScript Example

    '

    ' Example demonstrating the properties and methods on the

    ' UserDataItem object

    '

    dim oRoot, oTorus, oCluster, oUserDataMap, oUserData

    set oRoot = Application.ActiveProject.ActiveScene.Root

    set oTorus = oRoot.AddGeometry("Torus","NurbsSurface")

    set oCluster = oTorus.ActivePrimitive.Geometry.AddCluster( siBoundaryCluster )

    set oUserDataMap = oCluster.AddProperty("UserDataMap",, "NameOfProperty")

    set oUserData = oUserDataMap.Item( 0 )

    Application.LogMessage oUserData.IsEmpty & "/" & oUserData.Size & "/" & oUserData.Value

    ' We can save strings in the user data

    oUserData.Value = "Some content"

    Application.LogMessage oUserData.IsEmpty & "/" & oUserData.Size & "/" & oUserData.Value

    ' Output of this script is:

    'INFO : "True/0/"

    'INFO : "False/24/Some content"

### See Also

UserDataMap