CopyRect

CopyRect is a function in the Windows Graphics Device Interface (GDI) used to copy the coordinates of one rectangle to another. It copies the four integer fields that define a rectangle: left, top, right, and bottom, from a source RECT to a destination RECT. The operation does not allocate memory, perform any geometric change, or modify the source rectangle beyond copying its values to the destination.

The prototype is typically declared as VOID CopyRect(LPRECT lprcDst, const RECT* lprcSrc); or in C terms void CopyRect(RECT* lprcDst, const RECT* lprcSrc). The function takes two pointers: lprcDst is the destination RECT that will receive the values, and lprcSrc is the source RECT whose values are copied. The source is left unchanged, and the function returns no value.

Usage is straightforward: CopyRect replaces the destination rectangle with an exact copy of the source. Example: RECT src = {10, 20, 110, 70}; RECT dst; CopyRect(&dst, &src); After the call, dst contains {10, 20, 110, 70}.

Notes: The call requires inclusion of Windows headers and linking to GDI32.lib. CopyRect is a simple low-level utility; in MFC, similar behavior can be achieved with CRect::CopyRect or the assignment operator.

See also: SetRect, SetRectEmpty, IntersectRect, OffsetRect, InflateRect. These functions manipulate rectangle structures in various ways within the Windows API.