IDLitParameter::OnDataDisconnect

Syntax | Arguments | Keywords | Example | Version History

The IDLitParameter::OnDataDisconnect procedure method is called when a data value has been disconnected from a parameter. The general idea is that when a data item is disassociated from a visualization parameter, one or more properties of the visualization may need to be reset to reasonable default values.

Note
A visualization class based on the IDLitVisualization class must implement this method in order for changes or additions to the data parameters to be updated automatically in the resulting visualizations.

Syntax

Obj->[IDLitParameter::]OnDataDisconnect, ParameterName

Arguments

ParameterName

An upper-case string containing the name of the parameter that was disconnected. The parameter must have been previously registered with the visualization.

Keywords

None

Example

Normally, an implementation of this method will contain a CASE statement that switches based on the value of the ParameterName argument. For example, the following sample code performs some action when the parameter name is TEXTURE:

PRO MyVis::OnDataDisconnect, ParameterName 
 
CASE ParameterName OF  
   'TEXTURE': BEGIN 
   ;; do something to remove the ref. of the texture 
   END 
ENDCASE 
 
END 

Version History

6.0

Introduced