IdentifyLinkedFeature Method

Description

Identify any feature linked to a given McGraphObj instance.

Return Type

A Long value.

The Long Identifier of the linked feature, or -1 if not linked.

Syntax

object.IdentifyLinkedFeature (pimcgraphobjToGet, ppunkIMcFeaturesLinked)

The IdentifyLinkedFeature Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDisplayOverlays.
pimcgraphobjToGet	Required. A McGraphObj object. The McGraphObj instance to test for a linked feature. ppunkMcFeaturesLinked : The McFeatures-derived interface (McPoints, McLines or McRegions) associated with any identified linked feature. NULL (Nothing) will be returned if pimcgraphobjToGet is not linked.
ppunkIMcFeaturesLinked	Required. An Unknown object.

Remarks

If the McGraphObj instance argument (pimcgraphobjToGet) has a feature linked for display, the Identifier of that feature will be returned. If no feature is linked to the McGraphObj, then -1 is returned.

The McFeatures-derived interface (McPoints, McLines or McRegions) associated with any identified linked feature will be returned via the ppunkMcFeaturesLinked argument. The McGraphObj instance argument can be linked to a feature associated with any McFeatures, not just this DisplayOverlays collection's Parent. That is, the McGraphObj instance does not have to be linked to one of “our” features. However, if a linked feature is one of “ours”, then the object returned via the ppunkMcFeaturesLinked argument will be the same as our Parent property.

To find the feature index associated with the returned Identifier use the McFeatures.SelectorFromID method. To find the McGraphObj instances that are linked to a particular feature, use the McFeatures.DisplayedObjects to get an McDisplayedObjects collection for the feature(s) of interest.