CreatePenIndirect function

The CreatePenIndirect function creates a logical cosmetic pen that has the style, width, and color specified in a structure.

Syntax

HPEN CreatePenIndirect(
  const LOGPEN *plpen
);

Parameters

plpen

Pointer to a LOGPEN structure that specifies the pen's style, width, and color.

Return Value

If the function succeeds, the return value is a handle that identifies a logical cosmetic pen.

If the function fails, the return value is NULL.

Remarks

After an application creates a logical pen, it can select that pen into a device context by calling the SelectObject function. After a pen is selected into a device context, it can be used to draw lines and curves.

When you no longer need the pen, call the DeleteObject function to delete it.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

CreatePen

DeleteObject

ExtCreatePen

GetObject

LOGPEN

Pen Functions

Pens Overview

RGB

SelectObject