com.esri.arcgis.geodatabase
Interface INetworkTurn

All Superinterfaces:
INetworkElement, Serializable
All Known Subinterfaces:
INetworkTurn2
All Known Implementing Classes:
INetworkTurn2Proxy, INetworkTurnProxy, NetworkTurn

public interface INetworkTurn
extends INetworkElement, Serializable

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

Remarks

The INetworkTurn interface is used to access the properties of the network turn element, such as its turning angle.

Product Availability

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


Method Summary
 double getAngle()
          Angle of the turning movement described by this network turn.
 int getEdgeCount()
          Number of network edge elements that participate in this network turn.
 int getTurnType()
          Type of network turn.
 void queryAtJunction(INetworkJunction junction)
          Queries the at-junction of this network turn.
 void queryEdge(int index, INetworkEdge edge)
          Queries the index'th edge element of this network turn.
 
Methods inherited from interface com.esri.arcgis.geodatabase.INetworkElement
getAttributeValue, getAttributeValueByName, getEID, getElementType, getOID, getSourceID
 

Method Detail

getTurnType

int getTurnType()
                throws IOException,
                       AutomationException
Type of network turn.

Remarks

The TurnType property indicates whether or not this NetworkTurn is a turn element in the network.

If the TurnType is esriNTTImplicit, then this NetworkTurn represents an implicit turn. An implicit turn is a turning movement that is implied from two adjacent edge elements where there is no turn element in the network. An implicit turn can only be returned in a NetworkTurn object by the INetworkForwardStarAdjacencies::QueryTurn method.

If the TurnType is esriNTTExplicit, then this NetworkTurn represents a turn element in the network.

Product Availability

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

Returns:
A com.esri.arcgis.geodatabase.esriNetworkTurnType constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryAtJunction

void queryAtJunction(INetworkJunction junction)
                     throws IOException,
                            AutomationException
Queries the at-junction of this network turn.

Remarks

The QueryAtJunction method retrieves the junction element that anchors this turn element. The anchor junction of a turn element is the junction connecting the last two edges that the turn traverses.

This method requires an instantiated NetworkJunction 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:
junction - 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.

getAngle

double getAngle()
                throws IOException,
                       AutomationException
Angle of the turning movement described by this network turn.

Remarks

The Angle property returns the turning angle of the turn. The turning angle is determined by the difference in the azimuth values of the first and last edge elements of the turn.

The value returned for Angle ranges from 0 to 360. The Angle in measured clockwise from straight in degrees. Below are sample Angle values:

Product Availability

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

Returns:
The angle
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getEdgeCount

int getEdgeCount()
                 throws IOException,
                        AutomationException
Number of network edge elements that participate in this network turn.

Remarks

The EdgeCount is the number of edge element that this turn traverses.

Product Availability

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

Returns:
The edgeCount
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryEdge

void queryEdge(int index,
               INetworkEdge edge)
               throws IOException,
                      AutomationException
Queries the index'th edge element of this network turn.

Remarks

The QueryEdge method retrieves the edge element traversed by this turn at the specified index. The index values range from 0 to (EdgeCount - 1).

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:
index - The index (in)
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.