In this topic
- About selection trackers
- Selection tracker methods
- RotateTracker CoClass
- ScaleTracker CoClass
- AnchorPoint CoClass
The following are the three types of selection trackers:
-
Envelope tracker—An envelope tracker lets you move and resize the element. This functionality is implemented by the EnvelopeTracker object for all element types, including point, line, polygon, and group elements. See the following illustration:
-
Vertex edit tracker—A vertex edit tracker lets you move vertices of lines, polygons, curves, and curved text. This functionality is implemented by the LineTracker and PolygonTracker objects. See the following illustration:
-
Callout tracker—A callout tracker lets you move a text callout. This functionality is implemented by the CalloutTracker objects. See the following illustration:
Currently, the PointTracker object is not useful. Moving and resizing point elements is handled by envelope trackers with the size of the envelope corresponding to the symbolized point.
Although the selection trackers are coclasses, only cocreate one if you are building your own custom element when implementing IElement.SelectionTracker.
If you need to transform the geometry of an element programmatically, you can cast directly to the ITransform2D interface, which can be used to move, scale, and rotate the element. The selection tracker objects are intended to assist element transformations in an interactive context.
The ISelectionTracker interface controls the selection handle user interface. You can use ISelectionTracker to provide different behavior than that of the standard ArcMap interface; for example, the Element Movement tool that snaps elements to a grid. However, it is more likely that you will use this interface when building a custom object, such as an element. See the following illustration:
You can gain access to selection trackers with IElement.SelectionTracker, IElementEditVertices.GetMoveVerticesSelectionTracker, or IGraphicsContainerSelect.SelectionTracker. When using IElement, you get an envelope tracker or edit vertices tracker, depending on the state of the element. See the following illustration:
The following code example ensures that an envelope tracker is returned. If the element has a vertex edit tracker, it is changed to an envelope tracker and the document is refreshed.
static void ensureEnvelopeTracker(IActiveView activeView, IElement element)throws
Exception{
IScreenDisplay pScreenDisplay = activeView.getScreenDisplay();
if (element instanceof IElementEditVertices){
IElementEditVertices elementEditVertices = (IElementEditVertices)element;
if (elementEditVertices.isMovingVertices()){
elementEditVertices.setMovingVertices(false);
activeView.partialRefresh(esriViewDrawPhase.esriViewGraphicSelection,
null, element.getSelectionTracker().getBounds(pScreenDisplay));
}
}
}
After obtaining a reference to a selection tracker, set the Display property before using it. The Geometry property of a selection tracker applies to the tracker and not the element. For envelope trackers, the geometry is a polygon created from the envelope shape. For vertex edit trackers, the geometry is a polygon or polyline as appropriate. The Geometry property is updated when you finish reshaping the element with the selection tracker. The HitTest method provides information about the position of the mouse. The returned values are defined by esriTrackerLocation. See the following illustration:
Many of the ISelectionTracker methods—for example, OnMouseDown—correspond to user interface events. When controlling a selection tracker with a user interface tool, pass the tool events to the selection tracker. See the following code example:
static void doOnMouseMove(int button, int shift, int x, int y)throws Exception{
if (m_pSelTracker != null){
//Pass on the mouse move event to selection tracker
m_pSelTracker.onMouseMove(button, shift, x, y);
}
}
QueryMoveFeedback and QueryResizeFeedback return the feedback objects that the selection tracker is using.
Draw is called by ArcMap if the element is selected; normally, you don't need to use this method (it is important if you implement your own custom selection tracker). See the following illustration:
You normally use the ICalloutTracker interface when building custom elements since the symbol and its geometry can be obtained from the element or the ISelectionTracker.Geometry method.
The RotateTracker object manages the user interface for rotating features or elements. See the following illustration:
The rotate tracker does not provide facilities for manipulation of the rotation origin—use the AnchorPoint object to do this. See the following illustration:
The following illustration shows the IRotateTracker interface, which provides access to members that control the rotation tracker:
The IRotateTracker interface controls the rotation user interface. After cocreating a RotateTracker object, use the members in the following order: Display, Origin, ClearGeometry, then one or more calls to AddGeometry or AddPoint. If you are rotating a single polygon element, you need one call to AddGeometry for the element geometry; however, a rotation tracker can handle a group of elements. Use AddPoint for features with marker symbology. When using AddGeometry with elements whose size is determined by symbology, for example, text and marker elements, use the geometry of the element outline to get the correct feedback.
The following code example, given an element, returns a geometry suitable for AddGeometry:
[Java]
static IGeometry getElementGeometry(IElement element, IScreenDisplay screenDisplay)
throws Exception{
if (element instanceof IBoundsProperties){
IBoundsProperties boundsProperties = (IBoundsProperties)element;
if (boundsProperties.isFixedSize()){
IPolygon poly = new Polygon();
element.queryOutline(screenDisplay, poly);
return (IGeometry)poly;
}
}
return element.getGeometry();
}
The OnMouseDown, OnKeyDown, OnMouseMove, OnMouseUp, and Deactivate methods are event handlers. Call these methods from the corresponding events in your tool.
The OnMouseMove method provides user interface feedback for the rotation. Typically, you choose to update the feature or element in question in conjunction with the OnMouseUp method. This returns a Boolean expression indicating whether the element or feature was rotated. Get the amount of rotation from the Angle property; this can then be passed to ITransform2D.Rotate. IFeatureEdit.RotateSet can be useful for features.
If you pass the Key_Down event to OnKeyDown, pressing A prompts for an angle.
Similar to the rotation tracker, the scale tracker can be applied to one or more elements or features. The scale tracker manages the user interface for expansion or contraction of geometries by a scale ratio. See the following illustration:
You can add the ArcMap Editor Scale tool on the Customize dialog box. See the following illustration:
The following illustration shows the IScaleTracker interface, which provides access to members that control the scale tracker:
The IScaleTracker interface controls the user interface for scaling objects and is similar to IRotateTracker. The ScaleFactor property can be used to determine the defined scaling ratio. If you pass the Key-Down event to OnKeyDown, pressing F prompts for the scale factor.
When working with elements, an anchor point can be considered a helper object rather than an essential object. You need to cocreate the anchor point and manipulate it. This is useful when implementing your tools and objects; for example, a custom rotation tool.
The anchor point represents a point that can be used when manipulating elements and features. See the following illustration:
Anchor points can be useful for rotating elements and features and moving the origin of a text callout. See the following illustration:
The following illustration shows the IAnchorPoint interface, which provides access to members that control the tracker anchor point:
The IAnchorPoint interface provides facilities for controlling anchor points.
| Development licensing | Deployment licensing |
|---|---|
| ArcGIS for Desktop Basic | ArcGIS for Desktop Basic |
| ArcGIS for Desktop Standard | ArcGIS for Desktop Standard |
| ArcGIS for Desktop Advanced | ArcGIS for Desktop Advanced |
| Engine Developer Kit | Engine |