CPen::CPen

CPen( );

CPen ( Int nPenStyle, Int nWidth, COLORREF CrColor );
werfen ( CResourceException );

CPen ( Int nPenStyle, Int nWidth, const LOGBRUSH * pLogBrush, Int nStyleCount = 0, const DWORD * LpStyle = NULL );
werfen ( CResourceException );

Parameter

nPenStyle

Gibt den Stift Stil. Dieser Parameter in der ersten Version des Konstruktors kann eine der folgenden Werte sein.:

PS_SOLID&Nbsp; Erstellt einen festen Stift.
PS_DASH&Nbsp; Einen gestrichelten Stift erstellt. Nur gültig, wenn die Stiftbreite 1 oder weniger, in Gerät Einheiten ist.
PS_DOT&Nbsp; Einen gestrichelten Stift erstellt. Nur gültig, wenn die Stiftbreite 1 oder weniger, in Gerät Einheiten ist.
PS_DASHDOT&Nbsp; Erstellt einen Stift mit abwechselnden Striche und Punkte. Nur gültig, wenn die Stiftbreite 1 oder weniger, in Gerät Einheiten ist.
PS_DASHDOTDOT&Nbsp; Erstellt einen Stift mit abwechselnden Striche und doppelte Punkte. Nur gültig, wenn die Stiftbreite 1 oder weniger, in Gerät Einheiten ist.
PS_&NULLNbsp; Erstellt einen null-Stift.
PS_I&NSIDEFRAMENbsp; Erstellt einen Stift, der zeichnet eine Linie innerhalb des Rahmens von geschlossenen Formen produziert durch die Windows-GDI-Ausgabefunktionen, die ein umschließendes Rechteck (z. B. die Ellipse, Rechteck, RoundRect, Pieund Akkord -Memberfunktionen) angeben. Wenn dieser Stil mit Windows GDI-Ausgabefunktionen, die ein umschließendes Rechteck (z. B. der LineTo -Memberfunktion) nicht angeben verwendet wird, wird der editierbaren Bereich des Stiftes nicht durch einen Rahmen beschränkt.
Die zweite Version des Konstruktors CPen gibt eine Kombination der Art, Stil, Endkappe und Join-Attribute. Die Werte aus jeder Kategorie sollte mithilfe des bitweisen OR-Operators (|) kombiniert werden. Einen Typ des Stifts kann eine der folgenden Werte sein:
PS_GEOMETRIC&Nbsp; Erstellt einen geometrischen Stift.
PS_COSMETIC&Nbsp; Erstellt einen kosmetischen Stift.
Die zweite Version des Konstruktors CPen fügt die folgenden Stile Stift für nPenStyle:
PS_ALTER&NATENbsp; Erstellt einen Stift, der jeden anderen Pixel festlegt. (Dieser Stil gilt nur für kosmetische Stifte.)
PS_USERSTYLE&Nbsp; Erstellt einen Stift, der eine vom Benutzer angegebene Styling-Array verwendet.
Die Endkappe kann eine der folgenden Werte sein:
PS_E&NDCAP_ROUNDNbsp; Endkappen sind rund.
PS_E&NDCAP_SQUARENbsp; Endkappen sind quadratisch.
PS_E&NDCAP_FLATNbsp; Endkappen sind flach.
Die Verknüpfung kann eine der folgenden Werte sein:
PS_JOI&N_BEVELNbsp; Verknüpfungen sind gefast.
PS_JOI&N_MITERNbsp; Verknüpfungen sind mitered, wenn sie innerhalb der aktuellen von gesetzten Frist sind die :: SetMiterLimit Funktion. Wenn die Verknüpfung diesen Grenzwert überschreitet, ist es abgeschrägt.
PS_JOI&N_ROUNDNbsp; Verknüpfungen sind rund.

nWidth

Gibt die Breite des Stifts.

Für die erste Version des Konstruktors wenn dieser Wert 0, ist die Breite in Geräteeinheiten immer 1 Pixel, unabhängig von der Zuordnung.
Für die zweite Version des Konstruktors wenn 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

Wenn Sie den Konstruktor ohne Argumente verwenden, müssen Sie das resultierende CPen -Objekt mit den Memberfunktionen CreatePen, CreatePenIndirectoder CreateStockObject initialisieren. Verwenden Sie den Konstruktor, der Argumente akzeptiert, ist keine weitere Initialisierung notwendig. Der Konstruktor mit Argumenten kann eine Ausnahme auslösen, wenn Fehler aufgetreten sind, während der Konstruktor ohne Argumente immer gelingen wird,.

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

Siehe auch&Nbsp;CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject

Index