com.esri.arcgis.carto
Interface IScaleMarks

All Superinterfaces:

Serializable

All Known Implementing Classes:

AlternatingScaleBar, DoubleAlternatingScaleBar, HollowScaleBar, ScaleLine, SingleDivisionScaleBar, SteppedScaleLine

public interface IScaleMarks
extends Serializable

Provides access to members that control the scale bar mark properties.

Remarks

The IScaleMarks interface manages all of the properties of a scale bar that relate to the individual marks, including the division and subdivision marks heights and symbols, the marks frequency, and their position.

On the scale bar above, the tallest marks are the divisions and the smallest the subdivisions. You can control their height by setting the DivisionMarkHeight and SubdivisionMarkHeight properties.

You can also define the line symbols used for divisions and subdivisions with DivisionMarkSymbol and SubdivisionMarkSymbol. In this example the symbols where redefined as cartographic line symbols with butt ends.

The MarkPosition is an esriVertPosEnum constant that defines the position of the marks relatively to the line. On our example it is set to esriOn which results in marks centered on the line.

The MarkFrequency is an esriScaleBarFrequency constant that defines on which divisions and subdivisions the marks will be shown. Our example uses the value esriScaleBarDivisionsAndFirstSubdivisions to display the subdivisions only between the first divisions.

Product Availability

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

Method Summary

double	getDivisionMarkHeight() Height of division marks in points (1/72 inch).
ILineSymbol	getDivisionMarkSymbol() Symbol used to draw the division marks.
int	getMarkFrequency() Mark frequency.
int	getMarkPosition() Vertical positioning of the marks relative to the bar.
double	getSubdivisionMarkHeight() Height of subdivision marks in points (1/72 inch).
ILineSymbol	getSubdivisionMarkSymbol() Symbol used to draw the subdivision marks.
void	setDivisionMarkHeight(double points) Height of division marks in points (1/72 inch).
void	setDivisionMarkSymbol(ILineSymbol symbol) Symbol used to draw the division marks.
void	setMarkFrequency(int frequency) Mark frequency.
void	setMarkPosition(int position) Vertical positioning of the marks relative to the bar.
void	setSubdivisionMarkHeight(double points) Height of subdivision marks in points (1/72 inch).
void	setSubdivisionMarkSymbol(ILineSymbol symbol) Symbol used to draw the subdivision marks.

Method Detail

getDivisionMarkSymbol

ILineSymbol getDivisionMarkSymbol()
                                  throws IOException,
                                         AutomationException

Symbol used to draw the division marks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.display.ILineSymbol

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDivisionMarkSymbol

void setDivisionMarkSymbol(ILineSymbol symbol)
                           throws IOException,
                                  AutomationException

Symbol used to draw the division marks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

symbol - A reference to a com.esri.arcgis.display.ILineSymbol (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSubdivisionMarkSymbol

ILineSymbol getSubdivisionMarkSymbol()
                                     throws IOException,
                                            AutomationException

Symbol used to draw the subdivision marks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.display.ILineSymbol

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSubdivisionMarkSymbol

void setSubdivisionMarkSymbol(ILineSymbol symbol)
                              throws IOException,
                                     AutomationException

Symbol used to draw the subdivision marks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

symbol - A reference to a com.esri.arcgis.display.ILineSymbol (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDivisionMarkHeight

double getDivisionMarkHeight()
                             throws IOException,
                                    AutomationException

Height of division marks in points (1/72 inch). Use esriAutoScaleBar to automatically calculate.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The points

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDivisionMarkHeight

void setDivisionMarkHeight(double points)
                           throws IOException,
                                  AutomationException

Height of division marks in points (1/72 inch). Use esriAutoScaleBar to automatically calculate.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

points - The points (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSubdivisionMarkHeight

double getSubdivisionMarkHeight()
                                throws IOException,
                                       AutomationException

Height of subdivision marks in points (1/72 inch). Use esriAutoScaleBar to automatically calculate.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The points

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSubdivisionMarkHeight

void setSubdivisionMarkHeight(double points)
                              throws IOException,
                                     AutomationException

Height of subdivision marks in points (1/72 inch). Use esriAutoScaleBar to automatically calculate.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

points - The points (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMarkPosition

int getMarkPosition()
                    throws IOException,
                           AutomationException

Vertical positioning of the marks relative to the bar.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A com.esri.arcgis.carto.esriVertPosEnum constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMarkPosition

void setMarkPosition(int position)
                     throws IOException,
                            AutomationException

Vertical positioning of the marks relative to the bar.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

position - A com.esri.arcgis.carto.esriVertPosEnum constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMarkFrequency

int getMarkFrequency()
                     throws IOException,
                            AutomationException

Mark frequency.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A com.esri.arcgis.carto.esriScaleBarFrequency constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMarkFrequency

void setMarkFrequency(int frequency)
                      throws IOException,
                             AutomationException

Mark frequency.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

frequency - A com.esri.arcgis.carto.esriScaleBarFrequency constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.