Pen::P en(constColor&,REAL)-Methode (gdipluspen.h)

Artikel
01/10/2024

Erstellt ein Pen-Objekt , das eine angegebene Farbe und Breite verwendet.

Syntax

void Pen(
  [in, ref] const Color & color,
  [in]      REAL          width
);

Parameter

[in, ref] color

Typ: const Color

Verweis auf ein Color-Objekt , das die Farbe für dieses Pen-Objekt angibt.

[in] width

Typ: REAL

Optional. Reelle Zahl, die die Breite des Strichs dieses Stifts angibt. Der Standardwert ist 1,0. Wenn dieser Wert 0 ist, beträgt die Breite in Geräteeinheiten immer 1 Pixel, mit dem Unterschied, dass die width nicht von Skalierungstransformationsvorgängen beeinflusst wird, die für das Grafikobjekt gelten, für das verwendet Pen wird. Die Breite beträgt immer 1 Pixel.

Rückgabewert

Keine

Bemerkungen

Wenn Sie die Adresse eines Stifts an eine der Draw-Methoden eines Graphics-Objekts übergeben, hängt die Breite des Strichs des Stifts von der im Graphics-Objekt angegebenen Maßeinheit ab. Die Standardmaßeinheit ist UnitPixel, ein Element der Unit-Enumeration .

Beispiele

Im folgenden Beispiel wird ein Pen-Objekt mit der Farbe Rot und einer Breite von 4,0 erstellt.

Pen pen(Color(255,255,0,0), 4.0f);

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspen.h (einschließlich Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll