IASCrossHairs

This interface provides methods to manage a crosshairs control.

Method
Description
IASCrossHairs::get_AxisColor Gets the color used to draw the x-axis and the y-axis displayed in the cross hairs control.
IASCrossHairs::get_CrossHairBoxColor Gets the color of the box in the middle of the cross hair.
IASCrossHairs::get_CrossHairColor Gets the color of both axes of the cross hair itself.
IASCrossHairs::get_CrossHairHilite Gets the status of the cross hair highlight.
IASCrossHairs::get_CrossHairHiliteColor Gets the color of the cross hair axes when the axes are highlighted.
IASCrossHairs::get_XMinus Gets the minimum value of the x-axis.
IASCrossHairs::get_XPlus Gets the maximum positive value of the x-axis.
IASCrossHairs::get_XVal Gets the current value of the x-axis.
IASCrossHairs::get_YMinus Gets the minimum value of the y-axis.
IASCrossHairs::get_YPlus Gets the maximum positive value of the y-axis.
IASCrossHairs::get_YVal Gets the current value of the y-axis.
IASCrossHairs::put_AxisColor Sets the color used to draw the x-axis and the y-axis displayed in the cross hairs control.
IASCrossHairs::put_CrossHairBoxColor Sets the color of the box in the middle of the cross hair.
IASCrossHairs::put_CrossHairColor Sets the color of both axes of the cross hair itself.
IASCrossHairs::put_CrossHairHilite Sets the status of the cross hair highlight.
IASCrossHairs::put_CrossHairHiliteColor Sets the color of the cross hair axes when the axes are highlighted.
IASCrossHairs::put_XMinus Sets the minimum value of the x-axis.
IASCrossHairs::put_XPlus Sets the maximum positive value of the x-axis.
IASCrossHairs::put_XVal Sets the current value of the x-axis.
IASCrossHairs::put_YMinus Sets the minimum value of the y-axis.
IASCrossHairs::put_YPlus Sets the maximum positive value of the y-axis.
IASCrossHairs::put_YVal Sets the current value of the y-axis.

Remarks

The crosshairs control, which has a programmatic identifier equal to APC_Crosshair, works like an x-y graph. Both x and y lines can be adjusted separately. There is a maximum and minimum x- and y-coordinate and the position of the cross hair is specified by two values that fall in this range.

The target box stays inside the bounding rectangle at the extremes. This means that four pixels must be added to the height and width. To calculate the target box, use the following equations:

Height = 4 + (<number of vertical steps> * <pixels per step>)

Width = 4 + (<number of horizontal steps> * <pixels per step>)

The IASCrossHair interface, which has a global unique identifier (GUID) equal to IID_ASCROSSHAIRS, inherits from IASControl.