Pen::SetDashPattern-Methode (gdipluspen.h)
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 |