CRectTracker::Track

Статья
10/16/2008

Call this function to display the user interface for resizing the rectangle.

BOOL Track(
   CWnd* pWnd,
   CPoint point,
   BOOL bAllowInvert = FALSE,
   CWnd* pWndClipTo = NULL 
);

Параметры

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.
pWndClipTo
The window that drawing operations will be clipped to. If NULL, pWnd is used as the clipping rectangle.

Возвращаемое значение

If the ESC key is pressed, the tracking process is halted, the rectangle stored in the tracker is not altered, and 0 is returned. If the change is committed, by moving the mouse and releasing the left mouse button, the new position and/or size is recorded in the tracker's rectangle and nonzero is returned.

Заметки

This 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.

If bAllowInvert is TRUE, the tracking rectangle can be inverted on either the x-axis or y-axis.