com.esri.arcgis.geodatabase
Interface INetworkEdge

All Superinterfaces:

INetworkElement, Serializable

All Known Subinterfaces:

INetworkEdge2

All Known Implementing Classes:

INetworkEdge2Proxy, INetworkEdgeProxy, NetworkEdge

public interface INetworkEdge
extends INetworkElement, Serializable

Provides access to members that specify the properties of this network edge element.

Remarks

The INetworkEdge interface is used to access the properties of the network edge element, such as its direction of travel and azimuth values.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

int	getDirection() Direction in which this network edge element is oriented relative to the direction of its source object.
double	getFromAzimuth() Direction of travel at the from-end of the network edge element.
double	getPositionAlongObject(double positionAlongElement) Position along the source object at which the specified position along the network edge element lies.
double	getToAzimuth() Direction of travel at the to-end of the network edge element.
int	getTurnCount() Number of network turn elements in which this network edge element participates.
int	getTurnParticipationType() Participation of this network edge element within a network turn element.
void	queryEdgeInOtherDirection(INetworkEdge edge) Queries the network edge element corresponding to the reverse traversal of this network edge element.
void	queryJunctions(INetworkJunction fromJunction, INetworkJunction toJunction) Queries the network junction elements adjacent to this network edge element.
void	queryPositions(double[] fromPosition, double[] toPosition) Queries the positions along the source object at which the from-end and to-end of the network edge element lies.
void	queryTurn(int index, INetworkTurn turn) Queries the index'th network turn element in which this network edge element participates.

Methods inherited from interface com.esri.arcgis.geodatabase.INetworkElement

getAttributeValue, getAttributeValueByName, getEID, getElementType, getOID, getSourceID

Method Detail

getDirection

int getDirection()
                 throws IOException,
                        AutomationException

Direction in which this network edge element is oriented relative to the direction of its source object.

Remarks

The Direction property returns the direction of travel along this edge element relative to the digitized direction of the source feature. The direction of travel is either esriNEDAlongDigitized, meaning the direction of travel along the edge element is the same as the feature's direction of digitization, or esriNEDAgainstDigitized, meaning the direction of travel along the edge element is the opposite of the feature's direction of digitization.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

A com.esri.arcgis.geodatabase.esriNetworkEdgeDirection constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryPositions

void queryPositions(double[] fromPosition,
                    double[] toPosition)
                    throws IOException,
                           AutomationException

Queries the positions along the source object at which the from-end and to-end of the network edge element lies.

Remarks

The QueryPositions method queries the positional values along the source feature from which this edge element was created. The position values range 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.

If the Direction property is esriNEDAlongDigitized, then the fromPosition value will be less than or equal to the toPositionValue. If the Direction property is esriNEDAgainstDigitized, then the fromPosition value will be greater than or equal to the toPositionValue.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

fromPosition - The fromPosition (out: use single element array)

toPosition - The toPosition (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFromAzimuth

double getFromAzimuth()
                      throws IOException,
                             AutomationException

Direction of travel at the from-end of the network edge element.

Remarks

The FromAzimuth property indicates the direction of travel at the starting end of the edge element. For edge elements generated by an EdgeFeatureSource, the FromAzimuth and ToAzimuth values are measured clockwise in degrees relative to the positive Y-axis direction of the spatial reference of the network dataset.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

The fromAzimuth

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToAzimuth

double getToAzimuth()
                    throws IOException,
                           AutomationException

Direction of travel at the to-end of the network edge element.

Remarks

The ToAzimuth property indicates the direction of travel at the terminating end of the edge element. For edge elements generated by an EdgeFeatureSource, the FromAzimuth and ToAzimuth values are measured clockwise in degrees relative to the positive Y-axis direction of the spatial reference of the network dataset.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

The toAzimuth

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTurnParticipationType

int getTurnParticipationType()
                             throws IOException,
                                    AutomationException

Participation of this network edge element within a network turn element.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

A com.esri.arcgis.geodatabase.esriNetworkTurnParticipationType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPositionAlongObject

double getPositionAlongObject(double positionAlongElement)
                              throws IOException,
                                     AutomationException

Position along the source object at which the specified position along the network edge element lies.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

positionAlongElement - The positionAlongElement (in)

Returns:

The positionAlongObject

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTurnCount

int getTurnCount()
                 throws IOException,
                        AutomationException

Number of network turn elements in which this network edge element participates.

Remarks

The TurnCount property returns the number of turn elements that traverse this edge.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryTurn

void queryTurn(int index,
               INetworkTurn turn)
               throws IOException,
                      AutomationException

Queries the index'th network turn element in which this network edge element participates.

Remarks

The QueryTurn method retrieves the turn element that traverses this edge at the specified index. The index values range from 0 to (TurnCount - 1).

The QueryTurn method requires an instantiated NetworkTurn object to be passed in as a parameter. You can create an empty NetworkTurn object by using the INetworkQuery::CreateNetworkElement method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

index - The index (in)

turn - A reference to a com.esri.arcgis.geodatabase.INetworkTurn (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryEdgeInOtherDirection

void queryEdgeInOtherDirection(INetworkEdge edge)
                               throws IOException,
                                      AutomationException

Queries the network edge element corresponding to the reverse traversal of this network edge element.

Remarks

The QueryEdgeInOtherDirection method retrieves the edge element in the opposite direction of travel as this edge.

This method requires an instantiated NetworkEdge object to be passed in as a parameter. You can create an empty NetworkEdge object by using the INetworkQuery::CreateNetworkElement method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

edge - A reference to a com.esri.arcgis.geodatabase.INetworkEdge (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryJunctions

void queryJunctions(INetworkJunction fromJunction,
                    INetworkJunction toJunction)
                    throws IOException,
                           AutomationException

Queries the network junction elements adjacent to this network edge element.

Remarks

The QueryJunctions method retrieves the junction elements at the ends of this edge element.

This method requires two instantiated NetworkJunction objects to be passed in as a parameter. You can create an empty NetworkJunction object by using the INetworkQuery::CreateNetworkElement method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

fromJunction - A reference to a com.esri.arcgis.geodatabase.INetworkJunction (in)

toJunction - A reference to a com.esri.arcgis.geodatabase.INetworkJunction (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.