Die Community zu .NET und Classic VB.
Menü

CreatePen

 von 

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
nPenStyleGibt den Stiftstil an. Dafür wird einer der in der untenstehenden Tabelle aufgelisteten Werte verwendet.
nWidthGibt die Breite des resultierenden Stiftes in logischen Einheiten an.
crColorgibt die Farbe des resultierenden Stiftes an.

Tabelle 1


Stiftstile [nPenStyle]
PS_SOLIDDie mit dem Stift gezeichnete Linie oder Kurve ist durchgezogen.
PS_DASHDie 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_DOTDie 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_DASHDOTDie 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_DASHDOTDOTDie 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_NULLDie mit dem Stift gezeichnete Linie oder Kurve ist unsichtbar
PS_INSIDEFRAMEDie 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
LongWar die Funktion erfolgreich, wird das Handle den Stift zurückgegeben.
0Es lag ein Fehler vor.

Tabelle 3


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

Verwandte API-Funktionen
CreatePenIndirect, GetStockObject

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel