windows_programming_notes.nbk: Home | Index | Next Page: List of Messages to Windows | Previous Page: KillTimer

 LineTo

The LineTo function draws a line from the current position up to, but not including, the specified point.

    BOOL LineTo(
      HDC hdc,    // device context handle
      int nXEnd,  // x-coordinate of ending point
      int nYEnd   // y-coordinate of ending point
    );

Parameters

• hdc
  Handle to a device context.
• nXEnd
  Specifies the x-coordinate of the line's ending point.
• nYEnd
  Specifies the y-coordinate of the line's ending point.

Return Values

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. Windows NT/2000: To get extended error information, call GetLastError.

Remarks

The coordinates of the line's ending point are specified in logical units.

The line is drawn by using the current pen and, if the pen is a geometric pen, the current brush.

If LineTo succeeds, the current position is set to the specified ending point.

For an example, see Drawing Markers.

Requirements

• Windows NT/2000 or later: Requires Windows NT 3.1 or later.
• Windows 95/98/Me: Requires Windows 95 or later.
• Header: Declared in Wingdi.h; include Windows.h.
• Library: Use Gdi32.lib.

windows_programming_notes.nbk: Home | Index | Next Page: List of Messages to Windows | Previous Page: KillTimer

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time