PropertyObject.DeleteSubProperty

Syntax

PropertyObject.DeleteSubProperty( lookupString, options)

Purpose

Deletes the subproperty with the name the lookupString parameter specifies.

Remarks

Use the PropOption_DeleteIfExists option to prevent TestStand from returning errors if the specified property does not exist prior to calling this function.

To delete a specific element from a one-dimensional array, use the PropertyObject.DeleteElements method of the PropertyObject class.

To insert a new array element in a one-dimensional array at the specified offset, use the Set_ByOffset methods of the PropertyObject class and specify the PropOption_InsertElement flag.

Note TestStand does not support adding a new subproperty to an instance of a type unless you add the subproperty below a container you have marked as unstructured in the type definition by using the PropFlags_UnstructuredProperty flag. TestStand does not report any errors and creates the property, but does not save the property. When resolving type conflicts and updating type instances, TestStand automatically removes the property.

Parameters

lookupString As String

[In] Specifies the name of a subproperty within the PropertyObject. You can also pass lookup strings to this parameter.

options As Long

[In] Pass 0 to specify the default behavior, or pass one or more PropertyOptions constants. Use the bitwise-OR operator to specify multiple options.

See Also

Lookup Strings

Managing Type Revisions

PropertyFlags

PropertyObject.DeleteElements

PropertyObject.Exists

PropertyObject.InsertSubproperty

PropertyOptions

Thread Safety of the PropertyObject API and TestStand Variables