Freigeben über


Pen::SetDashStyle-Methode (gdipluspen.h)

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

Weitere Informationen

Zeichnen einer benutzerdefinierten gestrichelten Linie

Stift

Stift::GetDashCap

Stift::GetDashOffset

Stift::GetDashPattern

Pen::GetDashPatternCount

Stift::GetDashStyle

Stift::SetDashCap

Stift::SetDashOffset

Stift::SetDashPattern

Stifte, Linien und Rechtecke