IDLitVisualization::Add
Syntax | Arguments | Keywords | Version History
The IDLitVisualization::Add procedure method adds objects to the visualization container.
This method overrides the superclass IDLgrModel::Add method. This specialized implementation performs the following actions:
- Stores visualizations in the correct order based on type so that they are correctly displayed
- Adds the objects to appropriate positions
- Handles property aggregation (if the AGGREGATE keyword is set)
- Updates this visualization's state flags (indicating whether this visualization is 3-D, isotropic, etc.) as appropriate
- Sends notification that the scene needs to be redrawn (unless the NO_UPDATE keyword is set)
Syntax
Obj->[IDLitVisualization::]Add, Objects [, /AGGREGATE] [, /NO_UPDATE] [, POSITION=index]
Arguments
Objects
An object reference (or array of object references), each referring to an atomic graphic object, an IDLgrModel, or another IDLitVisualization object to be added to the visualization container.
Keywords
AGGREGATE
Set this keyword to indicate that the object(s) being added should become part of this visualization's property aggregate. The properties of all aggregated objects are exposed as properties of this visualization (accessible via the GetProperty and SetProperty methods). See Property Aggregation (iTool Developer's Guide) for additional details.
NO_UPDATE
Set this keyword to indicate that the overall scene should not be updated after the addition of the object(s). By default, the overall scene is updated.
POSITION
Set this keyword equal to a scalar or vector of zero-based index values. The number of elements specified must be equal to the number of object references specified by the Objects argument. Each index value specifies the position within this visualization container at which the corresponding object should be placed. The default is to add new objects at the end of the list of contained items.
Version History
For more information on deprecated features, see IDL API History.
