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