BCX_LINE function

Purpose: BCX_LINE draws a line from coordinates StartX%, StartY% to EndX%, EndY%.


Syntax:

 RetVal% = BCX_LINE(hWnd, _
                 StartX%, _
                 StartY%, _
                   EndX%, _
                   EndY%  _
                 [, Pen]  _
             [, DrawHDC])

Parameters:

  • hWnd Identifies the window where drawing takes place.
  • StartX X-coordinate start of line.
  • StartY Y-coordinate start of line.
  • EndX X-coordinate end of line.
  • EndY Y-coordinate end of line.
  • Pen [OPTIONAL] integer representing the RGB color code. The default is 0 which is a black pen.
  • DrawHDC [OPTIONAL] HDC (Handle to Device Context) pointing to an already open HDC. This is useful if a device context is to be written to many times. In this case the programmer is responsible for closing the HDC at the appropriate time.

Return Value:

  • RetVal% is a nonzero integer if the function succeeds, zero if the function fails.

Example: BCX_GRAFX_DEMO.bas