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.
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.
The return value is AX = 1 if successful. Otherwise, AX = 0.
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.