Pen::SetDashPattern-Methode (gdipluspen.h)

Artikel
08/24/2023

Die Pen::SetDashPattern-Methode legt ein Array benutzerdefinierter Bindestriche und Leerzeichen für dieses Pen-Objekt fest.

Syntax

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

Parameter

[in] dashArray

Typ: const REAL*

Zeiger auf ein Array reelle Zahlen, das die Länge der benutzerdefinierten Bindestriche und Leerzeichen angibt. Alle Elemente im Array müssen positive reelle Zahlen sein.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im DashArray-Array angibt. Die ganze Zahl muss größer als 0 und nicht größer als die Gesamtanzahl der Elemente im Array sein.

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

Diese Methode legt die DashStyle-Enumeration für dieses Pen-Objekt auf DashStyleCustom fest.

Die Elemente im DashArray-Array legen die Länge der einzelnen Bindestriche und Leerzeichen im Bindestrichmuster fest. Das erste Element legt die Länge eines Bindestrichs fest, das zweite Element die Länge eines Leerzeichens, das dritte Element legt die Länge eines Bindestrichs fest usw.

Die Länge der einzelnen Bindestriche und Leerzeichen im Bindestrichmuster ist das Produkt des Elementwerts im Array und die Breite des Pen-Objekts .

Beispiele

Im folgenden Beispiel wird ein Array mit reellen Zahlen erstellt. Der Code erstellt dann ein Pen-Objekt , legt das Bindestrichmuster basierend auf dem Array fest und zeichnet dann die benutzerdefinierte gestrichelte Linie.

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

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

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

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