CPen::CreatePen

BOOL CreatePen ( Int nPenStyle, Int nWidth, COLORREF CrColor );

BOOL CreatePen ( Int nPenStyle, Int nWidth, const LOGBRUSH * pLogBrush, Int nStyleCount = 0, const DWORD * LpStyle = NULL );

Rückgabewert

Nonzero oder das Handle der Stiftfarbe logischen, wenn erfolgreich; andernfalls 0.

Parameter

nPenStyle

Gibt den Stil für den Stift. Eine Liste der möglichen Werte finden Sie unter den nPenStyle -Parameter im Konstruktor CPen.

nWidth

Gibt die Breite des Stifts.

• Für die erste Version des CreatePenist dieser Wert 0, ist die Breite in Geräteeinheiten immer 1 Pixel, unabhängig von der Zuordnung.
  
  
• Für die zweite Version der CreatePenwenn nPenStyle PS_GEOMETRIC, ist die Breite in logischen Einheiten erhält. Wenn nPenStyle PS_COSMETICist, muss die Breite auf 1 gesetzt werden.

crColor

Enthält eine RGB-Farbe für den Stift.

pLogBrush

Verweist auf eine LOGBRUSH Struktur. Wenn nPenStyle PS_COSMETICist, der LbColor -Member der LOGBRUSH -Struktur gibt die Farbe des Stifts und der LbStyle -Member der LOGBRUSH -Struktur muss auf BS_SOLIDfestgelegt werden. Wenn nPenStyle PS_GEOMETRICist, müssen alle Member verwendet werden die Pinsel-Attribute des Stifts angeben.

nStyleCount

Gibt die Länge in Doppelwort-Einheiten, das LpStyle -Array. Dieser Wert muss NULL sein, wenn nPenStyle nicht PS_USERSTYLE ist.

lpStyle

Verweist auf ein Array Doppelwort Werte. Der erste Wert gibt die Länge des ersten Strichs in einem benutzerdefinierten Stil, der zweite Wert gibt die Länge der ersten Platz, und So weiter. This-Zeiger muss NULL sein, wenn nPenStyle nicht PS_USERSTYLE ist.

Bemerkungen

Die erste Version des CreatePen Initialisiert eine Pen mit der angegebenen Art, Breite und Farbe. Der Stift kann später als der aktuelle Stift für jede Gerätekontext ausgewählt werden.

Stifte, die größer als 1 Pixel Breite haben sollten immer die PS_NULL, PS_SOLIDoder PS_INSIDEFRAME haben.

Wenn ein Stift hat die PS_INSIDEFRAME Stil und eine Farbe, die eine Farbe in der logischen Farbtabelle nicht übereinstimmt, wird der Stift mit einem geditherte Farbe gezeichnet. Der PS_SOLID Stift Stil kann nicht verwendet werden, um einen Stift mit einem geditherte Farbe zu erstellen. Der Stil PS_INSIDEFRAME ist identisch mit PS_SOLID , wenn die Stiftbreite kleiner oder gleich 1 ist.

Die zweite Version der CreatePen initialisiert einen logischen kosmetischen oder geometrischen Stift mit dem angegebenen Stil, Breite, und Bürsten Sie Attribute. Eine kosmetische Stiftbreite ist immer 1. eine geometrische Stiftbreite wird immer in globalen Einheiten angegeben. Nachdem eine Anwendung einen logischen Stift erstellt hat, können sie den Stift einen Gerätekontext durch Aufrufen der CDC::SelectObjectauswählen Funktion. Nach ein Stift einen Gerätekontext ausgewählt ist, kann es verwendet werden, Zeichnen von Linien und Kurven.

• Ist nPenStyle PS_COSMETIC und PS_USERSTYLE, angeben die Einträge im LpStyle -Array Länge der Striche und Zwischenräume in Stil Einheiten. Eine Stil-Einheit ist durch das Gerät definiert, in dem der Stift zum Zeichnen einer Linie verwendet wird.
  
  
• NPenStyle PS_GEOMETRIC und PS_USERSTYLEist, geben die Einträge im LpStyle -Array Längen der Striche und Zwischenräume in logischen Einheiten.
  
  
• Wenn nPenStyle PS_ALTERNATEist, die Stil-Einheit ignoriert, und alle anderen Pixel festgelegt ist.

Wenn eine Anwendung einen bestimmten Stift nicht mehr benötigt, sollte es rufen die CGdiObject::DeleteObject -Memberfunktion oder zerstören Sie das Objekt CPen , so dass die Ressource nicht mehr verwendet wird. Eine Anwendung sollte keinen Stift löschen, wenn der Stift in einen Gerätekontext ausgewählt ist.

Übersicht über die CPen |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH