Output(OS_CIRCLE)

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

Draws a circle.

Returns one of these values:

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

lpDestDev

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

wStyle

Must be OS_CIRCLE.

wCount

Must be 2.

lpPoints

Address of an array that contains two POINT structures:

Index	Description
0	Upper-left corner of the bounding rectangle
1	Lower-right corner of the bounding rectangle

lpPPen

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

lpPBrush

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

lpDrawMode

Address of a DRAWMODE structure that contains information when drawing the border and filling the interior.

lpClipRect

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

Because the resulting figure is closed, Output fills the figure and draws the border. GDI calls this function when an application calls the Ellipse function (GDI.24) with a bounding rectangle that is square.

A graphics driver must support this style if the CC_CIRCLES value is set in the dpCurves member of the GDIINFO structure.

Output draws the circle by first filling the interior and then drawing the border. The center of the circle is at the center of the bounding rectangle; the radius is equal to half the width of the rectangle.

If a graphics driver can draw ellipses and has set the CC_ELLIPSES value in the dpCurves member, it does not need to set the CC_CIRCLES value in the dpCurves member. In such cases, GDI calls Output with the OS_ELLIPSE style when an application draws a circle.

Output(OS_CIRCLE)

See Also