IDLitParameterSet::Add
Syntax | Arguments | Keywords | Version History | See Also
The IDLitParameterSet::Add procedure method is used to add a data object to the parameter set.
Syntax
Obj->[IDLitParameterSet::]Add, Data [, PARAMETER_NAME=string] [, /PRESERVE_LOCATION]
Arguments
Data
An object reference or array of object references to IDLitData objects to be added to the parameter set.
Note
The objects to be added must be of class type IDLitData or a subclass of IDLitData. You cannot add the same Parameter Set object to itself.
Keywords
PARAMETER_NAME
Set this keyword to a string or array of strings containing the names of parameters to be associated with the data objects. If this value is not provided, a null string ('') is associated with the data object. If the value of this keyword is an array with fewer elements than the array specified as the Data argument, null strings are associated with data objects for which no parameter name is specified.
PRESERVE_LOCATION
Set this keyword to leave the PARENT property of all data items specified by the Data argument unchanged. Normally, when an item is added to a parameter set (or any data container), the item's PARENT property is changed to be the parameter set or data container object. This, in turn, changes the data item's identifier string, since the item's location in the iTools hierarchy has changed. (See iTool Object Identifiers (iTool Developer's Guide) for details.) In many cases, it is desirable to leave the PARENT property unchanged when adding items to a parameter set.
Version History
