Syntax

PropertyObject.Clone( lookupString, options)

Return Value

PropertyObject

Copy of the property. Release the copy when you finish using it.

Purpose

Creates a copy of the property the lookupString parameter specifies.

Remarks

This method does not always make an identical copy unless you use the bitwise-OR operator to specify the PropOption_DoNotShareProperties and PropOption_CopyAllFlags options.

You can create an alias object by using the PropOption_NotOwning option with the PropertyObject.SetPropertyObject or PropertyObject.SetPropertyObjectByOffset methods.

When you clone a step or a sequence, call the Step.CreateNewUniqueStepId or Sequence.CreateNewUniqueStepIds methods to replace the unique step ID with a new unique ID.

Parameters

lookupString As String

[In] Pass an empty string to denote the PropertyObject to which the method applies, or pass 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

PropertyObject

PropertyObject.SetPropertyObject

PropertyObject.SetPropertyObjectByOffset

PropertyOptions

Sequence.CreateNewUniqueStepIds

Step.CreateNewUniqueStepId

Thread Safety of the PropertyObject API and TestStand Variables