IMcMeasuresAddAll Method

Sub AddAll

By default the Measures collection for any given McFeatures object only holds those measurements that have been accessed in some way. Calling Item or Select will automatically add the referenced item(s) to the collection, as will directly accessing the measurement property by name (e.g., ActiveImage.RegionFeatures.mRgnArea). This approach is used because each measurement in the collection needs to be serviced whenever a change happens in any of the objects on which the standard dependencies are based. The overhead for each measurement is low, but there are often a large number of McFeatures objects, each of which has many avaliable measurements. Since object dependencies can also change frequently, the total wasted overhead is kept low by only servicing those measurements actually being used. For McFeatures where no measurements are being taken, there is no service overhead at all. However, in rare cases, you may need the collection to hold all available measurements. This can be accomplished with the AddAll method. After AddAll is called the Measures object can be used to iterate through all of the available measurements (see Example).

'List add the names of all McRegions measurements to a combo box
Dim TempMcRegions As McRegions
Set TempMcRegions = CreateOperator( "McRegions")
TempMcRegions.Measures.AddAll
Dim NextMcMeasure As McMeasure
For Each NextMcMeasure In TempMcRegions.Measures
ComboBox1.AddItem NextMcMeasure.DisplayName
Next 'NextMcMeasure
Set TempMcRegions = Nothing 'We are all done with the temporary McRegions