Pen::SetAlignment-Methode (gdipluspen.h)

Artikel
02/26/2024

Die Pen::SetAlignment-Methode legt die Ausrichtung für dieses Pen-Objekt relativ zur Linie fest.

Syntax

Status SetAlignment(
  [in] PenAlignment penAlignment
);

Parameter

[in] penAlignment

Typ: PenAlignment

Element der PenAlignment-Enumeration , das die Ausrichtungseinstellung des Stifts relativ zur gezeichneten Linie angibt. Der Standardwert ist PenAlignmentCenter.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Wenn Sie die Ausrichtung eines Pen-Objekts auf PenAlignmentInset festlegen, können Sie diesen Stift nicht verwenden, um zusammengesetzte Linien oder dreieckige Strichkappen zu zeichnen.

Beispiele

Im folgenden Beispiel werden zwei Pen-Objekte erstellt und die Ausrichtung für einen der Stifte festgelegt. Der Code zeichnet dann zwei Zeilen mit jedem stift.

VOID Example_SetAlignment(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a black and a green pen.
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen greenPen(Color(255, 0, 255, 0), 15);

   // Set the alignment of the green pen.
   greenPen.SetAlignment(PenAlignmentInset);

   // Draw two lines using each pen.
   graphics.DrawEllipse(&greenPen, 0, 0, 100, 200);
   graphics.DrawEllipse(&blackPen, 0, 0, 100, 200);
}

Anforderungen

Anforderung	Wert
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