Entities use various graphic primitives to draw themselves. Part of this mechanism is the ability to associate an integer identifier called a graphics system marker (or, GS marker) with each primitive or with groups of primitives. Through the use of certain selection mechanisms the GS marker for the actual subentity selected on screen can be obtained and used with this function and several other functions for various purposes such as highlighting or unhighlighting the subentity on screen.

This function uses the SubentId property within the subPath object to determine which GS markers within the entity are appropriate. Any GS markers that match are appended to the returned collection. 

The subPath object's object ID array is not used, so it does not need to be filled in. 

The SubentId object within subPath does needs to be fully filled in with the desired SubentityType and a valid index value (which may or may not actually be the GS marker). 

Typically, this function will be called with an FullSubentityPath object that was filled in by the entity's Entity.GetSubentityPathsAtGraphicsMarker() method. 

This function must be able to properly interpret the SubentityType and index values in the SubentId property within subPath in order to determine the GS markers for the corresponding subentity (or subentities). The GS markers thus determined are then appended to the returned collection. 

The index values in SubentId objects can be any values you want (they are often simply the GS markers themselves), but if implemented, the GetSubentityPathsAtGraphicsMarker() method must be able to calculate them based on a provided GS marker and, if implemented, the GetSubentity() method must be able to interpret them to determine the corresponding subentity (or subentities): 

Returns a collection of GSMarker(s) pointer(s) for the subentity (or subentities) 

Note The Entity.Highlight() and Entity.Unhighlight() methods both call this function to obtain the GS marker(s) associated with a FullSubentityPath. If this function is not overridden, then they will not work. 

Public Function GetGraphicsMarkersAtSubentityPathIntPtr(
    subPath As FullSubentityPath
) As IntPtrCollection

public IntPtrCollection GetGraphicsMarkersAtSubentityPathIntPtr(
    FullSubentityPath subPath
);