Pen::SetDashStyle-Methode (gdipluspen.h)

Artikel
02/27/2024

Die Pen::SetDashStyle-Methode legt das Bindestrichformat für dieses Pen-Objekt fest.

Syntax

Status SetDashStyle(
  [in] DashStyle dashStyle
);

Parameter

[in] dashStyle

Typ: DashStyle

Element der DashStyle-Enumeration , das den Bindestrichstil für dieses Pen-Objekt angibt.

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

Die Länge der Bindestriche in einer gestrichelten Linie hängt vom Bindestrichformat und der Breite des Pen-Objekts ab. Die Länge des Raums, der zwei Bindestriche in einer gestrichelten Linie trennt, entspricht der Breite des Pen-Objekts .

Beispiele

Im folgenden Beispiel wird ein Pen-Objekt erstellt, das Bindestrichformat festgelegt und eine Linie gezogen. Der Code setzt dann das Bindestrichformat zurück, zeichnet eine zweite Zeile, setzt das Bindestrichformat erneut zurück und zeichnet eine dritte Zeile.

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

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 255), 15);

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

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