FastBorder

  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.

Parameters

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.