C++ Syntax

void

MKI_DialogControlSetCoordinate(

HWND f_hWindow,

__int32 f_nTextCtlID,

__int32 f_nUnitCtlID,

const double f_dValue );

Converts a coordinate (that has already been converted to the currently active length unit) to a string and writes that string along with the current length unit to edit or text controls in a dialog window.

Resulting coordinates between -1.0e-100 and 1.0e-100 will always be displayed as 0.0 to avoid funny rounded displays such as -0.0.

Parameters

f_hWindow

[HWND] Handle of the dialog window that contains the controls.

f_nTextCtlID

[__int32] Identification number of the text or edit control to receive the coordinate value. Will be ignored if negative.

f_nUnitCtlID

[__int32] Identification number of the text or edit control to receive the coordinate unit. Will be ignored if negative.

f_dValue

[double] Floating point value to be converted into a string and displayed in the control. If the value is MKI_DOUBLE_NOVAL, the control will be cleared.

If you need to display a length value (such as a distance) that has not yet been converted to the currently active length unit, use MKI_DialogControlSetLength instead. If you want to display a coordinate pair that is originally saved in internal coordinates using the currently active length unit, use MKI_DialogControlSetPoint.