INetworkQuery.EdgesByPosition Property

Edge elements in the network dataset with a from and to position that includes the given position for the given source object.

[Visual Basic .NET]
Public Function get_EdgesByPosition ( _
    ByVal SourceID As Integer, _
    ByVal OID As Integer, _
    ByVal Position As Double, _
    ByVal includeRelatedSDCHyperEdges As Boolean _
) As IEnumNetworkElement

[C#]
public IEnumNetworkElement get_EdgesByPosition (
    int SourceID,
    int OID,
    double Position,
    bool includeRelatedSDCHyperEdges
);

[C++]
HRESULT get_EdgesByPosition(
  long SourceID,
  long OID,
  double Position,
  VARIANT_BOOL includeRelatedSDCHyperEdges,
  IEnumNetworkElement** Edges
);

[C++]
Parameters
SourceID [in]
  SourceID is a parameter of type long
OID [in]
  OID is a parameter of type long
Position [in]
  Position is a parameter of type double
includeRelatedSDCHyperEdges [in]
  includeRelatedSDCHyperEdges is a parameter of type VARIANT_BOOL
Edges [out, retval]
  Edges is a parameter of type IEnumNetworkElement

Product Availability

Remarks

The SourceID parameter is the unique ID assigned to the NetworkSource in the network dataset.

The Position parameter refers to the positional value along the source feature from which this edge element was created.  The Position parameter value ranges from 0.0 to 1.0, where 0.0 is at the from-end of the feature and 1.0 is at the to-end of the feature.

The includeRelatedSdcHyperEdges parameter determines whether the associated hyperedge elements are also returned in the enumeration.  If set to True, the network element associated with the given feature and position, along with all of the covering hyperedge elements will be returned.  If set to False, only the network element associated with the given feature and position will be returned.  This parameter only has an effect for SDC network datasets.  For other types of network datasets, this parameter has no effect as all elements associated with the given feature and position (whether hyperedge or not) will be returned.

The edge element(s) returned in the enumeration will be oriented in the esriNEDAlongDigitized Direction.  To get the edge element in the esriNEDAgainstDigitized Direction, call INetworkEdge::QueryEdgeInOtherDirection on the returned edge.

The EnumNetworkElement enumeration object returned by the EdgesByPosition property is recycling.  For enumerations with more than one network element returned, this means that the network element object returned by the first call to Next is expected to be reused in subsequent calls to Next.

See Also