CreatePenIndirect function

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 *lplgpn
);

Parameters

lplgpn [in]

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]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Pens Overview
Pen Functions
CreatePen
DeleteObject
ExtCreatePen
GetObject
LOGPEN
RGB
SelectObject

 

 

Show: