C++ Syntax

__int32

MKI_InputDialogProc(

__int32 f_nCommandID,

__int32 f_nPointIndex );

typedef __int32

(*MKI_INPUTDIALOG_PROC)(

__int32 f_nCommandID,

__int32 f_nPointIndex );

This procedure is called during the execution of an external command, i.e. a command that is handled by a plug-in.

Parameters

CommandID

[__int32] Identifier of the current command. Valid range: 0 <= Value < MKI_PLUGIN_MENU_MAX.

PointIndex

[__int32] Zero-based index of the point that is currently entered. Valid range: 0 <= Value < MKI_INPUT_MAX.

Return Value

Should return one of the following values:

MKI_INPUT_OK

Continue the entry of the current point because the user closed the coordinate entry dialog without entering data.

MKI_INPUT_NEXT

The coordinate entry was finished, continue immediately with the next point (or finish the command, if this was the final point).

MKI_INPUT_IDLE

This command does not support coordinate entry for this point, use the default coordinate entry method instead.

MKI_INPUT_IGNORE

This command does not allow any coordinate entry for this point, do not even use the default coordinate entry method instead.

MKI_INPUT_CANCEL

Cancel the complete command (usually due to user termination).

MKI_INPUT_FINISH

Finish the command, i.e. call MKI_InputFinishProc.

Comment

This procedure is called if the user calls the "coordinate entry" command, i.e. if he wants to enter values numerically. At this time, the plug-in should display any plug-in specific data entry dialogs (if any), or ignore this call by returning MKI_INPUT_IDLE.

The name MKI_InputDialogProc is only a placeholder, the procedure may have any name.