EdgesAsMcPoints Property
      
 

Description

A persistent or newly created McPoints object that holds points marking edges.

Property type

A McPoints object.  

Syntax

object.EdgesAsMcPoints([Selector])

The EdgesAsMcPoints Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McProfileEdges.
SelectorOptional. 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 Selector argument is a non-negative scalar value, then a newly created McPoints is returned with a “snapshot” of the edge points that currently exist on the selected ancestor feature.

If the Selector argument is a scalar value of negative one (-1), then a newly created McPoints is returned with a “snapshot” of the edge points that currently exist on all ancestor features.

If the Selector argument is Empty, Error or Null, or any negative scalar value other than -1, then the persistent edge points McPoints object will be returned. This McPoints object always holds the points of the current set of edges. As edges are added or removed, the edge points added, removed or repositioned.

If Selector is an array, then zero or positive values are treated as indices into the ancestor features collection; negative values are legal but ignored. In this case, a newly created McPoints is returned with a “snapshot” of the edge points that currently exist on just the selected features.

Remarks

The McPoints object exposed by this property will not normally be used to visibly mark the edges found or added to the McProfileEdges. For that you would probably use the EdgeTicMarksAsMcLines property. Instead, measurements on this property can be used to find information about the absolute location of the edge points. For example, the maPtLocationXY measurement will give the calibrated location of the “edges”.

You may access a newly created edge points McPoints with a “snapshot” of edges on all or selected ancestor features (this is accomplished by passing an argument of -1 for all features or a feature index or array of them for selected features). Alternately, you may access a persistently maintained McPoints object instance that always contains all current edge points on all ancestor features (this is the default property). This persistent edge points McPoints is automatically updated to reflect the current set of edges.

The McFeatures.SourceFlags property of any edge point McPoints feature is set to the McFeatures.Identifier of the ancestor feature that edge point. Similarly, the McFeatures.SourceData property of each edge point is set to the edge distance (see EdgeDistances) for the pointed-to edge. Thus, these two properties allow the identification of the exact edge associated with each point.

The edge point symbols in the returned McPoints are initially not displayed. To display them, you must enable “auto display”. Color of the edge point symbols are initially set to be the same as the color of any “McGraphObjLine” drawn on the MasterGraphOverlay of the ancestor McFeatures. You may override any of these defaults by accessing the edge point McPoints.AutoDisplayOverlay.