CreatePenIndirect function (wingdi.h)

Article
02/22/2024

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

Syntax

HPEN CreatePenIndirect(
  [in] const LOGPEN *plpen
);

Parameters

[in] 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

Requirement	Value
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