com.esri.arcgis.carto
Interface IDimensionShape

All Superinterfaces:

Serializable

All Known Implementing Classes:

DimensionShape

public interface IDimensionShape
extends Serializable

Provides access to members that control a dimension shape.

Description

The IDimensionShape interface supports properties for the definition of a dimension’s location and measurement.

Remarks

The BeginDimensionPoint and EndDimensionPoint properties define the Dimension’s measurement points. The DimensionLinePoint property determines the height of the dimension line above the baseline. To create a two point dimension, the DimensionLinePoint must be the same value as the BeginDimensionPoint. The ExtensionLineAngle property defines the angle between the dimension line and the extension line in degrees. This default angle is 90 degrees. Oblique dimensions have angles less than or greater than 90 degrees. The DimensionShape also supports a custom text location using the TextPoint property. For the default location of the dimension text, the TextPoint’s IGeometry::IsEmpty property should be True.

The TextAngle property is the angle of the text in radians. The TextAngle property will not affect the dimension if the dimension's style's text alignment property is True in which case the text is always parallel to the dimension line.

Product Availability

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

Method Summary

IPoint	getBeginDimensionPoint() The begin dimension point.
IPoint	getDimensionLinePoint() The point which describes the height of the dimension line.
IPoint	getEndDimensionPoint() The end dimension point.
double	getExtensionLineAngle() The angle of the extension lines in radians.
double	getTextAngle() The angle of the text in radians.
IPoint	getTextPoint() The point for the text placement.
void	setBeginDimensionPointByRef(IPoint point) The begin dimension point.
void	setDimensionLinePointByRef(IPoint point) The point which describes the height of the dimension line.
void	setEndDimensionPointByRef(IPoint point) The end dimension point.
void	setExtensionLineAngle(double angle) The angle of the extension lines in radians.
void	setTextAngle(double angle) The angle of the text in radians.
void	setTextPointByRef(IPoint point) The point for the text placement.

Method Detail

setBeginDimensionPointByRef

void setBeginDimensionPointByRef(IPoint point)
                                 throws IOException,
                                        AutomationException

The begin dimension point.

Remarks

The BeginDimensionPoint and EndDimensionPoint properties define the Dimension’s measurement points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBeginDimensionPoint

IPoint getBeginDimensionPoint()
                              throws IOException,
                                     AutomationException

The begin dimension point.

Remarks

The BeginDimensionPoint and EndDimensionPoint properties define the Dimension’s measurement points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geometry.IPoint

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEndDimensionPointByRef

void setEndDimensionPointByRef(IPoint point)
                               throws IOException,
                                      AutomationException

The end dimension point.

Remarks

The BeginDimensionPoint and EndDimensionPoint properties define the Dimension’s measurement points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getEndDimensionPoint

IPoint getEndDimensionPoint()
                            throws IOException,
                                   AutomationException

The end dimension point.

Remarks

The BeginDimensionPoint and EndDimensionPoint properties define the Dimension’s measurement points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geometry.IPoint

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDimensionLinePoint

IPoint getDimensionLinePoint()
                             throws IOException,
                                    AutomationException

The point which describes the height of the dimension line.

Remarks

The DimensionLinePoint property determines the height of the dimension line above the baseline. To create a two point dimension, the DimensionLinePoint must be the same value as the BeginDimensionPoint.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geometry.IPoint

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDimensionLinePointByRef

void setDimensionLinePointByRef(IPoint point)
                                throws IOException,
                                       AutomationException

The point which describes the height of the dimension line.

Remarks

The DimensionLinePoint property determines the height of the dimension line above the baseline. To create a two point dimension, the DimensionLinePoint must be the same value as the BeginDimensionPoint.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTextPoint

IPoint getTextPoint()
                    throws IOException,
                           AutomationException

The point for the text placement.

Remarks

The DimensionShape supports a custom text location using the TextPoint property. For the default location of the dimension text, the TextPoint’s IGeometry::IsEmpty property should be True.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geometry.IPoint

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTextPointByRef

void setTextPointByRef(IPoint point)
                       throws IOException,
                              AutomationException

The point for the text placement.

Remarks

The DimensionShape supports a custom text location using the TextPoint property. For the default location of the dimension text, the TextPoint’s IGeometry::IsEmpty property should be True.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

point - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getExtensionLineAngle

double getExtensionLineAngle()
                             throws IOException,
                                    AutomationException

The angle of the extension lines in radians.

Remarks

The ExtensionLineAngle property defines the angle between the dimension line and the extension line in degrees. This default angle is 90 degrees. Oblique dimensions have angles less than or greater than 90 degrees.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The angle

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setExtensionLineAngle

void setExtensionLineAngle(double angle)
                           throws IOException,
                                  AutomationException

The angle of the extension lines in radians.

Remarks

The ExtensionLineAngle property defines the angle between the dimension line and the extension line in degrees. This default angle is 90 degrees. Oblique dimensions have angles less than or greater than 90 degrees.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

angle - The angle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTextAngle

double getTextAngle()
                    throws IOException,
                           AutomationException

The angle of the text in radians.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The angle

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTextAngle

void setTextAngle(double angle)
                  throws IOException,
                         AutomationException

The angle of the text in radians.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

angle - The angle (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.