com.esri.arcgis.carto
Interface IScaleBar2

All Superinterfaces:

Serializable

All Known Implementing Classes:

AlternatingScaleBar, DoubleAlternatingScaleBar, HollowScaleBar, ScaleLine, SingleDivisionScaleBar, SteppedScaleLine

public interface IScaleBar2
extends Serializable

Provides access to members that control the scalebar map surrounds.

Product Availability

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

Method Summary

IColor	getBarColor() Color used to draw the bar.
double	getBarHeight() Height of the bar in points (1/72 inch).
double	getDivision() Number of units in one major division.
short	getDivisions() Total number of divisions (including those before zero).
short	getDivisionsBeforeZero() Number of divisions to the left of zero.
int	getLabelFrequency() The label style indicating which marks are labeled.
double	getLabelGap() Vertical gap between the bar and the labels in points (1/72 inch).
int	getLabelPosition() Vertical positioning of the mark labels.
ITextSymbol	getLabelSymbol() Symbol used to draw the labels.
INumberFormat	getNumberFormat() Number format.
int	getResizeHint() Indicates what happens when scale bar is resized.
short	getSubdivisions() Number of subdivisions per major division.
String	getUnitLabel() The unit label.
double	getUnitLabelGap() Gap between the scale bar and the unit label in points (1/72 inch).
int	getUnitLabelPosition() Vertical positioning of the unit label.
ITextSymbol	getUnitLabelSymbol() Unit label symbol.
int	getUnits() The units reported.
boolean	isUseFractionCharacters() Indicates if common decimal numbers are replaced by a fraction symbol, i.e., 1/2.
void	setBarColor(IColor color) Color used to draw the bar.
void	setBarHeight(double points) Height of the bar in points (1/72 inch).
void	setDivision(double units) Number of units in one major division.
void	setDivisions(short count) Total number of divisions (including those before zero).
void	setDivisionsBeforeZero(short count) Number of divisions to the left of zero.
void	setLabelFrequency(int labelFrequency) The label style indicating which marks are labeled.
void	setLabelGap(double points) Vertical gap between the bar and the labels in points (1/72 inch).
void	setLabelPosition(int position) Vertical positioning of the mark labels.
void	setLabelSymbol(ITextSymbol symbol) Symbol used to draw the labels.
void	setNumberFormat(INumberFormat format) Number format.
void	setResizeHint(int hint) Indicates what happens when scale bar is resized.
void	setSubdivisions(short units) Number of subdivisions per major division.
void	setUnitLabel(String unitLabel) The unit label.
void	setUnitLabelGap(double points) Gap between the scale bar and the unit label in points (1/72 inch).
void	setUnitLabelPosition(int position) Vertical positioning of the unit label.
void	setUnitLabelSymbol(ITextSymbol symbol) Unit label symbol.
void	setUnits(int units) The units reported.
void	setUseFractionCharacters(boolean flag) Indicates if common decimal numbers are replaced by a fraction symbol, i.e., 1/2.
void	useMapSettings() Sets division and units based on map.

Method Detail

getDivision

double getDivision()
                   throws IOException,
                          AutomationException

Number of units in one major division.

Product Availability

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

Returns:

The units

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDivision

void setDivision(double units)
                 throws IOException,
                        AutomationException

Number of units in one major division.

Product Availability

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

Parameters:

units - The units (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDivisions

short getDivisions()
                   throws IOException,
                          AutomationException

Total number of divisions (including those before zero).

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.

setDivisions

void setDivisions(short count)
                  throws IOException,
                         AutomationException

Total number of divisions (including those before zero).

Product Availability

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

Parameters:

count - The count (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDivisionsBeforeZero

short getDivisionsBeforeZero()
                             throws IOException,
                                    AutomationException

Number of divisions to the left of zero.

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.

setDivisionsBeforeZero

void setDivisionsBeforeZero(short count)
                            throws IOException,
                                   AutomationException

Number of divisions to the left of zero.

Product Availability

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

Parameters:

count - The count (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSubdivisions

short getSubdivisions()
                      throws IOException,
                             AutomationException

Number of subdivisions per major division.

Product Availability

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

Returns:

The units

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSubdivisions

void setSubdivisions(short units)
                     throws IOException,
                            AutomationException

Number of subdivisions per major division.

Product Availability

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

Parameters:

units - The units (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnits

int getUnits()
             throws IOException,
                    AutomationException

The units reported.

Product Availability

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

Returns:

A com.esri.arcgis.system.esriUnits constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUnits

void setUnits(int units)
              throws IOException,
                     AutomationException

The units reported.

Product Availability

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

Parameters:

units - A com.esri.arcgis.system.esriUnits constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnitLabel

String getUnitLabel()
                    throws IOException,
                           AutomationException

The unit label.

Product Availability

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

Returns:

The unitLabel

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUnitLabel

void setUnitLabel(String unitLabel)
                  throws IOException,
                         AutomationException

The unit label.

Product Availability

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

Parameters:

unitLabel - The unitLabel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnitLabelPosition

int getUnitLabelPosition()
                         throws IOException,
                                AutomationException

Vertical positioning of the unit label.

Product Availability

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

Returns:

A com.esri.arcgis.carto.esriScaleBarPos constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUnitLabelPosition

void setUnitLabelPosition(int position)
                          throws IOException,
                                 AutomationException

Vertical positioning of the unit label.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnitLabelGap

double getUnitLabelGap()
                       throws IOException,
                              AutomationException

Gap between the scale bar and the unit label in points (1/72 inch).

Product Availability

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

Returns:

The points

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUnitLabelGap

void setUnitLabelGap(double points)
                     throws IOException,
                            AutomationException

Gap between the scale bar and the unit label in points (1/72 inch).

Product Availability

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

Parameters:

points - The points (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnitLabelSymbol

ITextSymbol getUnitLabelSymbol()
                               throws IOException,
                                      AutomationException

Unit label symbol.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUnitLabelSymbol

void setUnitLabelSymbol(ITextSymbol symbol)
                        throws IOException,
                               AutomationException

Unit label symbol.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLabelFrequency

int getLabelFrequency()
                      throws IOException,
                             AutomationException

The label style indicating which marks are labeled.

Product Availability

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

Returns:

A com.esri.arcgis.carto.esriScaleBarFrequency constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLabelFrequency

void setLabelFrequency(int labelFrequency)
                       throws IOException,
                              AutomationException

The label style indicating which marks are labeled.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getNumberFormat

INumberFormat getNumberFormat()
                              throws IOException,
                                     AutomationException

Number format.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.system.INumberFormat

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setNumberFormat

void setNumberFormat(INumberFormat format)
                     throws IOException,
                            AutomationException

Number format.

Product Availability

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

Parameters:

format - A reference to a com.esri.arcgis.system.INumberFormat (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLabelPosition

int getLabelPosition()
                     throws IOException,
                            AutomationException

Vertical positioning of the mark labels.

Product Availability

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

Returns:

A com.esri.arcgis.carto.esriVertPosEnum constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLabelPosition

void setLabelPosition(int position)
                      throws IOException,
                             AutomationException

Vertical positioning of the mark labels.

Product Availability

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

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.

getLabelGap

double getLabelGap()
                   throws IOException,
                          AutomationException

Vertical gap between the bar and the labels in points (1/72 inch).

Product Availability

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

Returns:

The points

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLabelGap

void setLabelGap(double points)
                 throws IOException,
                        AutomationException

Vertical gap between the bar and the labels in points (1/72 inch).

Product Availability

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

Parameters:

points - The points (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLabelSymbol

ITextSymbol getLabelSymbol()
                           throws IOException,
                                  AutomationException

Symbol used to draw the labels.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLabelSymbol

void setLabelSymbol(ITextSymbol symbol)
                    throws IOException,
                           AutomationException

Symbol used to draw the labels.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBarColor

IColor getBarColor()
                   throws IOException,
                          AutomationException

Color used to draw the bar.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBarColor

void setBarColor(IColor color)
                 throws IOException,
                        AutomationException

Color used to draw the bar.

Product Availability

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

Parameters:

color - A reference to a com.esri.arcgis.display.IColor (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBarHeight

double getBarHeight()
                    throws IOException,
                           AutomationException

Height of the bar in points (1/72 inch).

Product Availability

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

Returns:

The points

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBarHeight

void setBarHeight(double points)
                  throws IOException,
                         AutomationException

Height of the bar in points (1/72 inch).

Product Availability

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

Parameters:

points - The points (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getResizeHint

int getResizeHint()
                  throws IOException,
                         AutomationException

Indicates what happens when scale bar is resized.

Product Availability

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

Returns:

A com.esri.arcgis.carto.esriScaleBarResizeHint constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setResizeHint

void setResizeHint(int hint)
                   throws IOException,
                          AutomationException

Indicates what happens when scale bar is resized.

Product Availability

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

Parameters:

hint - A com.esri.arcgis.carto.esriScaleBarResizeHint constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

useMapSettings

void useMapSettings()
                    throws IOException,
                           AutomationException

Sets division and units based on map.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isUseFractionCharacters

boolean isUseFractionCharacters()
                                throws IOException,
                                       AutomationException

Indicates if common decimal numbers are replaced by a fraction symbol, i.e., 1/2.

Product Availability

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

Returns:

The flag

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUseFractionCharacters

void setUseFractionCharacters(boolean flag)
                              throws IOException,
                                     AutomationException

Indicates if common decimal numbers are replaced by a fraction symbol, i.e., 1/2.

Product Availability

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

Parameters:

flag - The flag (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.