IDLitVisualization::Add

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).

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.

Obsolete Keywords

The following keyword is obsolete:

GROUP

For information on obsolete keywords, see Obsolete Features.

Version History

Introduced: 6.0

Obsoleted GROUP keyword: 6.1