VCLButtonDownWorldPoint


Version:

1.2

Description:

Invokes a left button down message at the specified "real world" drawing coordinates.

Declaration:

 

C/C++

extern "C" void WINAPI VCLButtonDownWorldPoint(Point2D* dpW);

Delphi

procedure VCLButtonDownWorldPoint(var dpW: Point2D); stdcall;

ActiveX/COM

Function LButtonDownWorldPoint(dpW As IVCPoint2D) As IVCPoint2D

Parameters:

dpW is the Point2D structure specifying where in the drawing area the left click is to take place.

Notes:

VCLButtonDownWorldPoint issues a click at the real world position in the drawing. This is related to the drawing area and size. If a click is needed in a specific screen area use VCLButtonDown2 instead. This command can be used to select drawing entities or to locate points of a drawing or editing tool in the drawing area. This behaves exactly as the user clicking in the drawing area to select drawing coordinates.

Important:  Before using the point, VCADD will apply any active constraints (e.g. Ortho) to it.  The value of the dpW point parameter may be different after the function returns.  The new value of the point will be the actual value used by VCADD.  The ActiveX/COM version does not alter the point passed in and returns the new point.

See Also:

VCLButtonDown, VCLButtonDown2, VCRButtondown, VCMButtonDown