Pen::SetDashCap-Methode (gdipluspen.h)

Artikel
08/24/2023

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

Syntax

Status SetDashCap(
  [in] DashCap dashCap
);

Parameter

[in] dashCap

Typ: DashCap

Element der DashCap-Enumeration , die die Bindestrichkappe 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

Wenn Sie die Ausrichtung eines Pen-Objekts auf PenAlignmentInset festlegen, können Sie diesen Stift nicht verwenden, um dreieckige Bindestrichkappen zu zeichnen.

Beispiele

Im folgenden Beispiel wird ein Pen-Objekt erstellt, das Bindestrichformat und die Bindestrichkappe festgelegt und eine gestrichelte Linie gezogen.

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

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

   // Set the dash style for the pen.
   pen.SetDashStyle(DashStyleDash);

   // Set a triangular dash cap for the pen.
   pen.SetDashCap(DashCapTriangle);

   // Draw a line using the pen.
   graphics.DrawLine(&pen, 20, 20, 200, 100);
}

Anforderungen


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