Description

Creates a new McIntensityCalib instance and adds it to the McIntensityCalibs collection.

Return Type

A McIntensityCalib object.  

McIntensityCalib* the new calibration.

Syntax

object.AddEx (Name, Flags)

The AddEx Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McIntensityCalibs.
NameRequired. A String value.

The name given to the McIntensityCalib.Name property. If an empty name is supplied, the Name is “calibration#”. See McIntensityCalib.Name for more details.

FlagsRequired. A mccfCalibFlags enumeration, as described in settings.

The calibration flags applied to the new calibration.

Settings

The settings for Flags are:

ConstantValueDescription
 mccfIsReference1

If set, the calibration is a reference calibration

 mccfIsSystem2

If set, the calibration is the system calibration

 mccfWasDerived256

If set, the calibration was derived from another calibration masks

 mccfUserFlags-65536

Flags for use by user

 mccfAddFlags-65281

All unmasked flags are ignored by AddEx and Flags property assignment

 mccfNoFlags0
 mccfAllFlags-1

Remarks

new

An McIntensityCalib instance is created with the specified name and flags. Other properties are initialized to default values. The new calibration is also added to the IntensityCalibs collection.

“For each” enumerations will only find McIntensityCalib instances which are part of the collection, and there is no need to keep an AddRef on the interface instance. McIntensityCalibs.Item will return only collection members for numeric (index value) arguments, but it will find any calibration with a matching Name for string arguments, whether the calibration is part of the calibrations collection or not.

Exceptions

Resource limits.

Notes

The new calibration is also added to the IntensityCalibs collection.