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.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
WORD FastBorder(lpRect, wHorizBorderThick, wVertBorderThick, dwRasterOp,
                lpDestDev, lpPBrush, lpDrawMode, lpClipRect)
LPRECT lpRect;
WORD wHorizBorderThick;
WORD wVertBorderThick;
DWORD dwRasterOp;
LPDEVICE lpDestDev;
LPBRUSH lpPBrush;
LPDRAWMODE lpDrawMode;
LPRECT lpClipRect;
 
The FastBorder function draws a rectangle with a border on the screen.
However, the size is subject to the limits imposed by the specified clipping
rectangle. The border is drawn within the boundaries of the specified
rectangle.
 
Parameter          Description
────────────────────────────────────────────────────────────────────────────
 
lpRect             Points to a RECT structure specifying the rectangle to be
                   framed.
 
wHorizBorderThick  Specifies the width in pixels of the left and right
                   borders.
 
wVertBorderThick   Specifies the width in pixels of the top and bottom
                   borders.
 
dwRasterOp         Specifies the raster operation to be used.
 
lpDestDev          Points to a PDEVICE structure that identifies the device
                   to receive the output.
 
lpPBrush           Points to a PBRUSH structure.
 
lpDrawMode         Points to a DRAWMODE structure that includes the current
                   text color, background mode, background color, text
                   justification, and character spacing. See the DRAWMODE
                   data structure description in Chapter 12,
                   "Graphics-Driver Types and Structures," for a description
                   of text justification and character spacing.
 
lpClipRect         Points to a RECT structure specifying the clipping
                   rectangle.
 
Return Value
 
The return value is AX = 1 if successful. Otherwise, AX = 0.
 
Comments
 
The export ordinal for this function is 17.
 
The specified rectangle should be given as (UpperLeftCorner,
LowerRightCorner). If it is specified incorrectly, the sample function will
draw the borders outside of the specified rectangle, instead of correctly
drawing them inside.
 
The function is optional for display drivers. It is required at the GDI
level but not at the display level.
 
The raster operation to be used will never have a source operand within it.
 
The lpDrawMode parameter is simply a long pointer to the DRAWMODE data
structure. It is included only for compatibility with earlier versions and
is not crucial. The only field that you may use from there is
BackgroundColor.
 
                                      ♦