CM QUERYRECORDRECT

This message returns the rectangle of the specified container record, relative to the container window origin.

Syntax

param1
PRECTL prclItem;             /* Pointer to the RECTL structure, into which the rectangular coordinates are placed. */

param2
PQUERYRECORDRECT pQueryRecordRect; /* Pointer to the QUERYRECORDRECT structure. */

Parameters

prclItem (PRECTL) - Input

Pointer to the RECTL structure, into which the rectangular coordinates are placed.

pQueryRecordRect (PQUERYRECORDRECT) - Input

Pointer to the QUERYRECORDRECT structure.

Returns

rc (BOOL) - returns

Success indicator.

TRUE: A rectangle with valid coordinates is returned.

FALSE: The rectangle is not successfully returned. The WinGetLastError function may return the following error:

PMERR_INVALID_PARAMETERS.

Remarks

The coordinates of the returned rectangle are in window coordinates.

If the input record is not found in the container, the output rectangle is empty.

For a container using the details view (CV_DETAIL), all of the data for a row is returned in the rectangle.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it other than to return FALSE.