Description

Removes a calibration from the collection.

Return Type

None  

Nothing

Syntax

object.Remove Index

The Remove Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McIntensityCalibs.
IndexRequired. A Variant value.

Remarks

McObject notify clients have an opportunity to prevent the removal of a calibration from the collection (see Notes). Furthermore, the calibration will actually be destroyed only when all references to it have been fully released. However, once a calibration is removed from the calibrations collection an Item lookup on it will fail, even if it still exists.

Exceptions

E_INVALIDARG : If the calibration cannot be found.

Notes

Calibrations can only be removed from the collection when there are no open images that are using them. Trying to remove a calibration that is still in use will result in an E_INVALIDARG exception.

Removing a calibration from the collection changes the collection index associated with all calibrations added after the removed calibration.

The BeforeClose event is raised before a calibration is removed from the collection. If any of the notify clients cancel the removal, then no further clients are notified.

The Close event is raised to notify clients after the calibration is removed from the collection, but before it is given its Release.