Pen::SetDashOffset-Methode (gdipluspen.h)
Die Pen::SetDashOffset-Methode legt den Abstand vom Zeilenanfang bis zum Anfang des ersten Bindestrichs in einer gestrichelten Linie fest.
Syntax
Status SetDashOffset(
[in] REAL dashOffset
);
Parameter
[in] dashOffset
Typ: REAL
Reelle Zahl, die angibt, wie oft die Leerzeichen in einer gestrichelten Linie verschoben werden. Jede Verschiebung entspricht der Länge eines Leerzeichens in der gestrichelten Linie.
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
Ein positiver dashOffset-Wert verschiebt den ersten Bindestrich entlang des Pfads nach vorne, und ein negativer DashOffset-Wert verschiebt den Anfang des Pfads entlang des ersten Bindestrichs nach vorne.
Beispiele
Im folgenden Beispiel wird ein Pen-Objekt erstellt, das Bindestrichformat festgelegt und eine Linie gezogen. Der Code legt dann den Offsetwert des Stifts fest und zeichnet eine zweite Zeile.
VOID Example_SetDashOffset(HDC hdc)
{
Graphics graphics(hdc);
// Create a Pen object, set the dash style, and draw a line.
Pen pen(Color(255, 0, 0, 255), 15);
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 50, 400, 50);
// Set the dash offset value for the pen, and draw a second line.
pen.SetDashOffset(10);
graphics.DrawLine(&pen, 0, 80, 400, 80);
}
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 |