CRectTracker::TrackRubberBand

BOOL TrackRubberBand( CWnd* pWnd, CPoint point, BOOL bAllowInvert = TRUE );

Return Value

Nonzero if the mouse has moved and the rectangle is not empty; otherwise 0.

Parameters

pWnd

The window object that contains the rectangle.

point

Device coordinates of the current mouse position relative to the client area.

bAllowInvert

If TRUE, the rectangle can be inverted along the x-axis or y-axis; otherwise FALSE.

Remarks

Call this function to do rubber-band selection. It is usually called from inside the function of your application that handles the WM_LBUTTONDOWN message (typically OnLButtonDown).

This function will capture the mouse until the user releases the left mouse button, presses the ESC key, or presses the right mouse button. As the user moves the mouse cursor, the feedback is updated by calling DrawTrackerRect and OnChangedRect.

Tracking is performed with a rubber-band-type selection from the lower-right handle. If inverting is allowed, the rectangle can be sized by dragging either up and to the left or down and to the right.

CRectTracker OverviewClass MembersHierarchy Chart

See Also   CRectTracker::DrawTrackerRect, CRectTracker::OnChangedRect, CRectTracker::CRectTracker