Pen::SetDashOffset-Methode (gdipluspen.h)

Artikel
02/29/2024

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