com.esri.arcgis.editor
Interface IDigitizerButtons

All Superinterfaces:

Serializable

All Known Implementing Classes:

DigitizerExtension, IDigitizerButtonsProxy

public interface IDigitizerButtons
extends Serializable

Provides access to map digitizer puck buttons to ArcMap commands.

Remarks

Commands or tools that are mapped to digitizer buttons will only work when in digitizing mode. To use the digitizer puck in digitizing mode you must check the 'Enabled' check box on the Digitizer tab of the Editor Options dialog box.

When digitizing is enabled, the only tools that display a cursor on the screen when you move the puck are the sketch tools; you will not, for example, see the Edit tool cursor when it is the active tool and you are driving it from the digitizing board. For tools other than the sketch tools, you must rely on the position of the puck. Mouse events work the same for all tools. For example, when the Edit tool is the active tool, pressing the 'Left Click' button will select the feature over which the puck is positioned but looking at the screen will not show you the Edit tool's position.

When To Use

The IDigitizerButtons interfaces allows you to map Arc Map commands directly to the buttons on the digitizer puck. For example, button 4 can be mapped to the Edit tool, button 5 mapped to the Sketch tool, and button 6 mapped to the Arc tool.

Product Availability

Available with ArcGIS Desktop.

See Also:

IDigitizerSetup.getControlPointCount(), IDigitizerSetup.getControlPoint(int, double[], double[], double[], double[]), IDigitizerSetup, IEditAttributeProperties, IDigitizerSetup.getTransformation(), IDigitizerSetup.clearControlPoints(), IDigitizerSetup.addControlPoint(double, double, double, double)

Method Summary

IUID	getButton(int button) Button to map on the digitizer puck.
void	setButton(int button, IUID cmdID) Button to map on the digitizer puck.

Method Detail

setButton

void setButton(int button,
               IUID cmdID)
               throws IOException,
                      AutomationException

Button to map on the digitizer puck.

Product Availability

Available with ArcGIS Desktop.

Parameters:

button - The button (in)

cmdID - A reference to a com.esri.arcgis.system.IUID (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getButton

IUID getButton(int button)
               throws IOException,
                      AutomationException

Button to map on the digitizer puck.

Product Availability

Available with ArcGIS Desktop.

Parameters:

button - The button (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.