IDLitComponent::SetProperty

The IDLitComponent::SetProperty procedure method sets the value of an IDLitComponent property or properties.

Obj->[IDLitComponent::]SetProperty[, PROPERTY=value] [, /NO_COPY]

None

Any property listed under IDLitComponent Properties that contains the word “Yes” in the “Set” column of the properties table can be set using this method. To set the value of a property, specify the property name as a keyword set equal to the appropriate property value.

NO_COPY

Note: This keyword only has an effect when setting the UVALUE property.

Usually, when setting the UVALUE property, IDL makes a copy of the data being transferred. Although this technique is fine for small data, it can have a significant memory cost when the data being copied is large.

If the NO_COPY keyword is set, IDL handles the SetProperty operation differently. Rather than copy the source data, it takes the data away from the source and attaches it directly to the destination. This feature can be used to obtain the information from the UVALUE property without the memory copying that would otherwise occur. However, it has the side effect of causing the source variable to become undefined; in a call to the SetProperty method, this means that the variable passed in as UVALUE becomes undefined.

Version History

6.0	Introduced
6.4	Added NO_COPY keyword.