Pen::GetDashPattern-Methode (gdipluspen.h)

Artikel
08/24/2023

Die Pen::GetDashPattern-Methode ruft ein Array von benutzerdefinierten Bindestrichen und Leerzeichen ab, die derzeit für dieses Pen-Objekt festgelegt sind.

Syntax

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

Parameter

[out] dashArray

Typ: REAL*

Zeiger auf ein Array, das die Länge der Bindestriche und Leerzeichen in einer benutzerdefinierten gestrichelten Linie empfängt.

[in] count

Typ: INT

Eine ganze Zahl, die die Anzahl der Elemente im DashArray-Array 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, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Die Elemente im dashArray-Array legen die Länge jedes Bindestrichs und des Abstands im Bindestrichmuster fest. Das erste Element legt die Länge eines Bindestrichs fest, das zweite Element legt die Länge eines Leerzeichens fest, das dritte Element legt die Länge eines Bindestrichs fest usw.

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

Beispiele

Im folgenden Beispiel wird ein Array mit reellen Zahlen und einem Pen-Objekt erstellt, das Bindestrichmuster festgelegt und eine benutzerdefinierte gestrichelte Linie zeichnert. Der Code ruft dann das Bindestrichmuster ab, das derzeit für den Stift festgelegt ist.

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

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 (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll