EdgeTicMarksAsMcLines Property
      
 

Description

A persistent or newly created McLines object that holds “tic marks” pointing to edges.

Property type

A McLines object.  

Syntax

object.EdgeTicMarksAsMcLines([Selector])

The EdgeTicMarksAsMcLines 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 McLines is returned with a “snapshot” of lines pointing to the edges that currently exist on the selected ancestor feature.

If the Selector argument is a scalar value of negative one (-1), then a newly created McLines is returned with a “snapshot” of lines pointing to the edges 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 tic marks McLines object will be returned. This McLines object always holds lines pointing to the current set of edges. As edges are added or removed, the tic mark lines are automatically 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 McLines is returned with a “snapshot” of lines pointing to the edges that currently exist on just the selected features.

Remarks

The McLines object exposed by this property will normally be used to visibly mark the edges found or added to the McProfileEdges. The “tic mark” consists of a single stroke starting at the “edge” location on the ancestor McLines or McRegions of the ProfilesAncestor. The tic mark will be TicMarkLength pixels long and will be drawn at TicMarkOrientation degrees counterclockwise from the ancestor line segment that the edge falls on. A text label will be placed at the end of the tic mark line if the TicMarkLabel property is not an empty string.

You may access a newly created tic mark McLines 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 McLines object instance that always marks all current edges on all ancestor features (this is the default property). This persistent tic marks McLines is automatically updated to reflect the current set of edges and the current tic mark drawing parameters (TicMarkLength, TicMarkOrientation and TicMarkLabel).

The McFeatures.SourceFlags property of any tic mark McLines feature is set to the McFeatures.Identifier of the ancestor feature that the tic mark points to. Similarly, the McFeatures.SourceData property of each tic mark 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 tic mark.

The tic mark strokes in the returned McLines are initially not displayed. To display them, you must enable “auto display”. Color of the tic mark strokes and label text are initially set to be the same as the color of any “McGraphObjLine” Template on the AutoDisplayOverlay of the ancestor McFeatures. Similarly, the tic mark stroke witdth is also inherited from the that Template. Tic mark display is set up so that tic mark strokes and labels do not zoom when the image is zoomed. You may override any of these defaults by accessing the tic mark McLines.AutoDisplayOverlay.