Output(OS_RECTANGLE)

WORD Output(LPPDEVICE lpDestDev, WORD wStyle, WORD wCount, 
    LPPOINT lpPoints, LPPPEN lpPPen, LPPBRUSH lpPBrush, 
    LPDRAWMODE lpDrawMode, LPRECT lpClipRect);

Draws a rectangle and fills it using a specified brush.

Returns one of these values:

1	Function was successful.
0	Unrecoverable error occurred.
-1	Function does not support the specified style.

lpDestDev

Address of a PDEVICE or PBITMAP structure that specifies the destination device or bitmap.

wStyle

Must be OS_RECTANGLE.

wCount

Must be 2.

lpPoints

Address of an array of two POINT structures that represents the corners of the rectangle.

lpPPen

Address of a PPEN structure that specifies the physical pen that is used to draw the border of the rectangle.

lpPBrush

Address of a PBRUSH structure that specifies the physical brush that is used to fill the rectangle.

lpDrawMode

Address of a DRAWMODE structure that contains the drawing information to draw and fill the rectangle.

lpClipRect

Address of a RECT structure that contains coordinates for the clipping rectangle. If the lpClipRect parameter is NULL, the clipping rectangle is the entire display surface.

GDI calls this function when an application calls the Rectangle function (GDI.27).

The graphics driver must support the OS_RECTANGLE style if the PC_RECTANGLE value is set in the dpPolygonals member of the GDIINFO structure.

The Output function fills the interior of the rectangle first and then draws the border. Before filling and drawing, Output must subtract one from the bottom and right coordinates. GDI requires that rectangles are drawn so that the border lies one pixel within the specified right and bottom edges.

See also PDEVICE, PBITMAP, DRAWMODE, RECT, POINT