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 |