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.

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