C# Signature:

[DllImport("gdi32.dll")]
static extern IntPtr CreatePen(PenStyle fnPenStyle, int nWidth, uint crColor);

VB.NET Signature:

<DllImport("gdi32.dll")> _
Private Shared Function CreatePen(fnPenStyle As PenStyle, nWidth As Integer, crColor As UInteger) As IntPtr
End Function

User-Defined Types:

PenStyle

public enum PenStyle : int
{
    PS_SOLID        = 0, //The pen is solid.
    PS_DASH         = 1, //The pen is dashed.
    PS_DOT          = 2, //The pen is dotted.
    PS_DASHDOT      = 3, //The pen has alternating dashes and dots.
    PS_DASHDOTDOT       = 4, //The pen has alternating dashes and double dots.
    PS_NULL         = 5, //The pen is invisible.
    PS_INSIDEFRAME      = 6,// Normally when the edge is drawn, it’s centred on the outer edge meaning that half the width of the pen is drawn
            // outside the shape’s edge, half is inside the shape’s edge. When PS_INSIDEFRAME is specified the edge is drawn
            //completely inside the outer edge of the shape.
    PS_USERSTYLE    = 7,
    PS_ALTERNATE    = 8,
    PS_STYLE_MASK       = 0x0000000F,

    PS_ENDCAP_ROUND     = 0x00000000,
    PS_ENDCAP_SQUARE    = 0x00000100,
    PS_ENDCAP_FLAT      = 0x00000200,
    PS_ENDCAP_MASK      = 0x00000F00,

    PS_JOIN_ROUND       = 0x00000000,
    PS_JOIN_BEVEL       = 0x00001000,
    PS_JOIN_MITER       = 0x00002000,
    PS_JOIN_MASK    = 0x0000F000,

    PS_COSMETIC     = 0x00000000,
    PS_GEOMETRIC    = 0x00010000,
    PS_TYPE_MASK    = 0x000F0000
};

Notes:

None.

Tips & Tricks:

Please add some!

Sample Code:

// create a bitmap and get a pointer suitable for GDI

Bitmap maskImage = new Bitmap (width, height);

Graphics maskg = Graphics.FromImage(maskImage);

IntPtr maskHbitmap = maskImage.GetHbitmap();

void PaintLine3(IntPtr hbitmap, Point start, Point end, bool erase)

{

    IntPtr pTarget = maskg.GetHdc();
    IntPtr pDC = CreateCompatibleDC(pTarget);
    IntPtr pOrig = SelectObject(pDC, hbitmap);

    Color penColor = Color.Blue;
    int penWidth = 20;

    IntPtr pen = CreatePen(PenStyle.PS_SOLID | PenStyle.PS_GEOMETRIC | PenStyle.PS_ENDCAP_ROUND, penWidth, (uint)ColorTranslator.ToWin32(penColor));

    // select the pen into the device context
    IntPtr oldpen = SelectObject(pDC, pen);

    MoveToEx(pDC, start.X, start.Y, IntPtr.Zero);
    LineTo(pDC, end.X, end.Y);

    // select the old pen back
    DeleteObject(SelectObject(pDC, oldpen));
    SelectObject(pDC, pOrig);
    maskg.ReleaseHdc();

}

Alternative Managed API:

Do you know one? Please contribute it!

Please edit this page!

Do you have...

• helpful tips or sample code to share for using this API in managed code?
• corrections to the existing content?
• variations of the signature you want to share?
• additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).