Windows 3.1 Device Drivers (ddag31qh.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
Output(OS_ROUNDRECT)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
WORD Output(lpDestDev, OS_ROUNDRECT, 3, lpPoints, lpPPen, lpPBrush,
lpDrawMode, lpClipRect)
LPPDEVICE lpDestDev;
LPPOINT lpPoints;
LPPPEN lpPPen;
LPPBRUSH lpPBrush;
LPDRAWMODE lpDrawMode;
LPRECT lpClipRect;
The OS_ROUNDRECT style specifies that the Output function draws and fills a
rectangle having rounded corners. GDI calls this function when an
application calls the RoundRect function (GDI.28).
The graphics driver must support the OS_ROUNDRECT style if the CC_ROUNDRECT
value is set in the dpCurves member of the GDIINFO structure.
Parameter Description
────────────────────────────────────────────────────────────────────────────
lpDestDev Points to a PDEVICE or PBITMAP structure specifying the
destination device or bitmap.
lpPoints Points to an array of three POINT structures representing the
corners of the rectangle and the width and height of the ellipse
used to draw the corners.
lpPPen Points to a PPEN structure that specifies the physical pen to
draw the border of the rectangle.
lpPBrush Points to a PBRUSH structure that specifies the physical brush
to fill the rectangle.
lpDrawMode Points to a DRAWMODE structure containing the drawing
information to draw and fill the rectangle.
lpClipRect Points to a RECT structure containing coordinates for the
clipping rectangle. If the lpClipRect parameter is NULL, the
clipping rectangle is the entire display surface.
Return Value
The return value is 1 if the function draws the figure. Otherwise, it is
zero if the function encounters an unrecoverable error. The return value is
-1 if the function cannot draw the specified figure and wants GDI to
simulate it.
Comments
The Output function fills the interior of the rectangle first, then draw the
border. Before filling and drawing, Output must subtract one from the bottom
and right coordinates. GDI requires that rectangles are draw so that the
border lies one pixel within the specified right and bottom edges.
See Also
Output(OS_ALTPOLYGON), Output(OS_RECTANGLE), Output(OS_WINDPOLYGON)
♦