Description

The measurement's current value

Property type

A Variant value.  

Syntax

object.value([varSelector])

The value Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McHeterogeneity.
varSelectorOptional. A Variant value.

An empty Variant, a single negative value, a single index value, or an array of zero or more index values (negative index values are legal but will be ignored).

If the varSelector argument is a non-negative scalar value, then
the measurement of the indicated feature from the Value is
returned as with dimensionality reduced by one (that is if the Value
is a 1-D array, this will be a scalar; if a 2-D array it will be
a 1-D array and so on).

If the varSelector argument is Empty, Error or Null, or any negative scalar,
then the entire Value property is exposed.  The number of elements in the
slowest moving dimension of the array will be equal to the Count property.

If varSelector is an array, then zero or positive values are
treated as indices into the slowest moving Value dimension, negative values
are legal but ignored.  In this case, the Value is exposed with only the
selected elements present.

This argument is only legal for measurements that yield a numeric
result; i.e., where Attributes(mcmaidResultType) is mcmrtNumeric.


Remarks

McMeasLnBasic properties and methods

The Value property will be computed or recomputed as necessary when it is accessed. Since the Value property is the default for McMeasure, you can usually just access it by specifying the measurement name (see examples).

The Value is exposed as a Variant, the type of which can be determined from ValueMcObject.ValueType.

If Attributes(mcmaidPerFeatureMeasurement) is True (as it usually is), the Value will be an array of 1 or more dimensions. Each element of the slowest moving dimension of the array (the rightmost for VB, the leftmost for C-like languages) is the measurement taken from one of the Count features of the parent McFeatures. For example, the McRegions.mRgnArea measurement is a one-dimensional array, one scalar area from each of the McRegions.Count sub-regions (i.e., features). And McRegions.maRgnRadii is a two-dimensional array consisting of McRegions.Count rows, each of McMeasureAngles.NumAngles in length. Since there may be zero features, the array length of the Value's slowest dimension may be zero; this dimensions will always be Count in length.

The number of dimensions and shape of the Value property may be determined from the Attributes(mcmaidNofDimensions) and Attributes(mcmaidShape).

Notes

Calling this method automatically adds this McMeasure to the Measures collection.