CreatePen

Deklaration  

Declare Function CreatePen Lib "gdi32" ( _
                 ByVal nPenStyle As Long, _
                 ByVal nWidth As Long, _
                 ByVal crColor As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel CreatePen des API-Wikis.

CreatePen erzeugt unter Verwendung der vorgegebenen Werte für Breite, Stil und Farbe einen logischen Stift. Dieser kann zum zeichnen von Linien und Kurven verwendet werden.

Parameter
nPenStyle	Gibt den Stiftstil an. Dafür wird einer der in der untenstehenden Tabelle aufgelisteten Werte verwendet.
nWidth	Gibt die Breite des resultierenden Stiftes in logischen Einheiten an.
crColor	gibt die Farbe des resultierenden Stiftes an.

Tabelle 1

Stiftstile [nPenStyle]
PS_SOLID	Die mit dem Stift gezeichnete Linie oder Kurve ist durchgezogen.
PS_DASH	Die mit dem Stift gezeichnete Linie oder Kurve ist gestrichelt. Für diesen Stil müssen Sie eine Stiftbreite angeben, die eine oder weniger Geräteeinheiten beträgt.
PS_DOT	Die mit dem Stift gezeichnete Linie oder Kurve ist gepunktet. Für diesen Stil müssen Sie eine Stiftbreite angeben, die eine oder weniger Geräteeinheiten beträgt.
PS_DASHDOT	Die mit dem Stift gezeichnete Linie oder Kurve besteht abwechselnd aus Punkten und und Strichen. Für diesen Stil müssen Sie eine Stiftbreite angeben, die eine oder weniger Geräteeinheiten beträgt.
PS_DASHDOTDOT	Die mit dem Stift gezeichnete Linie oder Kurve besteht abwechselnd aus aus einem Strich und zwei Punkten. Für diesen Stil müssen Sie eine Stiftbreite angeben, die eine oder weniger Geräteeinheiten beträgt.
PS_NULL	Die mit dem Stift gezeichnete Linie oder Kurve ist unsichtbar
PS_INSIDEFRAME	Die mit dem Stift gezeichnete Linie oder Kurve ist durchgezogen. Wenn die GDI-Funktion, die mit diesem Stift zeichnet, ein umgrenzendes Rechteck als Parameter verwendet, wird die Abbildung so verkleinert, daß sie vollständig in das umgrenzende Rechteck paßt, nachdem die Stiftbreite berücksichtigt wurde. Dieses Verhalten trifft nur für geometrische Stifte zu.

Tabelle 2

Rückgabewerte
Long	War die Funktion erfolgreich, wird das Handle den Stift zurückgegeben.
0	Es lag ein Fehler vor.

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreatePenIndirect, GetStockObject

Zugehörige Tipps

• Auf dem Desktop mit GDI-Werkzeugen zeichnen [Tipp 0125]

Zugehörige Microsoft Knowledge Base Artikel

• HOWTO: Use SetCapture and WindowFromPoint to Select a Window