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.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMESSAGEMGR
 
BOOL WinDrawBorder(hps, prcl, cx, cy, clrFore, clrBack, fsCmd)
HPS hps;         /* handle of the presentation space             */
PRECTL prcl;     /* address of structure with bounding rectangle */
SHORT cx;        /* width of the border                          */
SHORT cy;        /* height of the border                         */
LONG clrFore;    /* color of the foreground                      */
LONG clrBack;    /* color of the background                      */
USHORT fsCmd;    /* border-drawing flags                         */
 
The WinDrawBorder function draws a border (a rectangular frame, normally
used around the edge of a window).
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space in which the border is drawn.
 
prcl       Points to a RECTL structure that contains the bounding rectangle
           for the border. The border is drawn within this rectangle.
 
cx         Specifies the width of the left and right sides of the border
           rectangle.
 
cy         Specifies the height of the top and bottom sides of the border
           rectangle.
 
clrFore    Specifies the color of the foreground.
 
clrBack    Specifies the color of the background.
 
fsCmd      Specifies the flags that determine how the border is drawn. It
           can be one of the following values:
 
           Value           Meaning
           ─────────────────────────────────────────────────────────────────
           DB_AREAMIXMODE  Draws the border with the current area
                           attributes, using the current-area foreground mix
                           mode mapped to a GpiBitBlt raster operation. Note
                           that the background mix mode is ignored by
                           WinDrawBorder in this release because GpiBitBlt
                           ignores it.
 
           DB_DESTINVERT   Inverts the border.
 
           DB_DLGBORDER    A standard dialog border is drawn. If DB_PATCOPY
                           is specified, then an active dialog border is
                           drawn. If DB_PATINVERT is specified, then an
                           inactive dialog border is drawn. If this option
                           is specified, the cx and cy parameters are
                           ignored.
 
           DB_INTERIOR     The interior of the border is drawn with the
                           current pattern background color. The border is
                           drawn in the current pattern foreground color.
 
           DB_PATCOPY      Draws the border with the current area
                           attributes, forcing a mix mode of ROP_SRCCOPY.
 
           DB_PATINVERT    Draws the border with the current area
                           attributes, forcing a mix mode of ROP_PATINVERT.
 
           DB_ROP          Used as a mask to isolate the raster operation
                           related flags of the fsCmd parameter.
 
           DB_STANDARD     The cx and cy parameters are multiplied by the
                           system SV_CXBORDER and SV_CYBORDER constants to
                           produce the width and height of the border
                           sides.
 
           The current area attributes pattern is used. For instance, if the
           caller selects a diagonal-crosshatch symbol, the borders will be
           drawn with diagonal crosshatches, no matter what colors are
           selected. The only raster operation which does not use the
           pattern is DB_DESTINVERT.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
See Also
 
GpiBitBlt, RECTL
 
                                      ♦