VCMButtonDownEx

Version:

6.0

Description:

Sends a middle button down message to Visual CADD™ to behave as if it were a middle button click in the Visual CADD™ drawing area.

Declaration:

C/C++

extern "C" void WINAPI VCMButtonDownEx(long lParam, WORD wParam);

Delphi

procedure VCMButtonDownEx(lParam: LongInt; wParam: SmallInt); stdcall;

ActiveX/COM

Sub MButtonDownEx(ByVal lParam As long, ByVal wParam As short)

Parameters:

lParam - a packed coordinate pair as used by Windows.
wParam - passed by Windows functions to represent the identifier of the mouse message.

Return Value:

None.

iError Code:

None.

Notes:

VCMButtonDownEx and VCMButtonUp invoke the same behavior as a middle button click in the drawing area of the Visual CADD™ user interface. As of version 6, the user interface behavior of a middle button click-and-release (no mouse move between middle button down and up) in the Visual CADD™ drawing area is to run any script assigned to the middle mouse button as B2 in Assign Script, and if no script is assigned then display the corresponding popup menu. The user interface behavior of a middle button click-and-drag (a mouse move while holding down the middle button) in the Visual CADD™ drawing area is to run the Auto Pan tool which will pan the current drawing view as the mouse is dragged. Unlike legacy behavior of VCMButtonDown, for which there was no corresponding middle button up, VCMButtonDownEx and VCMButtonUp must occur in pairs because the click-and-release cannot be distinguished from click-and-drag until the middle button goes up. Note that the Visual CADD™ user interface behavior of the middle button click may change in future versions and it is by design that VCMButtonDownEx and VCMButtonUp will change accordingly and continue to have the same behavior as in the user interface.

Refer to Windows documentation of WM_MBUTTONDOWN and WM_MBUTTONUP for discussion of the parameters passed to VCMButtonDownEx and VCMButtonUp.