Pen::SetCompoundArray-Methode (gdipluspen.h)
Die Pen::SetCompoundArray-Methode legt das zusammengesetzte Array für dieses Pen-Objekt fest.
Syntax
Status SetCompoundArray(
[in] const REAL *compoundArray,
[in] INT count
);
Parameter
[in] compoundArray
Typ: const REAL*
Zeiger auf ein Array mit reellen Zahlen, das das zusammengesetzte Array angibt. Die Elemente des Arrays müssen aufsteigend sortiert und dürfen nicht kleiner als 0 und nicht größer als 1 sein.
[in] count
Typ: INT
Positive sogar ganze Zahl, die die Anzahl der Elemente im compoundArray-Array angibt. Die ganze Zahl darf nicht größer als die Anzahl der Elemente im zusammengesetzten 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
Angenommen, Sie möchten, dass ein Stift zwei parallele Linien zeichnen soll, wobei die Breite der ersten Zeile 20 Prozent der Breite des Stifts beträgt, die Breite des Abstands, der die beiden Linien trennt, 50 Prozent der Breite des Stifts und die Breite der zweiten Zeile 30 Prozent der Breite des Stifts. Erstellen Sie zunächst ein Pen-Objekt und ein Array von reellen Zahlen. Anschließend können Sie das zusammengesetzte Array festlegen, indem Sie das Array mit den Werten 0.0, 0.2, 0.7 und 1.0 an die Pen::SetCompoundArray-Methode des Pen-Objekts übergeben.
Wenn Sie die Ausrichtung eines Pen-Objekts auf PenAlignmentInset festlegen, können Sie diesen Stift nicht verwenden, um zusammengesetzte Linien zu zeichnen.
Beispiele
Im folgenden Beispiel wird ein Pen-Objekt erstellt und das zusammengesetzte Array für den Stift festgelegt. Der Code zeichnet dann eine Linie mit dem Pen-Objekt .
VOID Example_SetCompoundArray(HDC hdc)
{
Graphics graphics(hdc);
// Create an array of real numbers and a Pen object.
REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
Pen pen(Color(255, 0, 0, 255), 30);
// Set the compound array of the pen.
pen.SetCompoundArray(compVals, 6);
// Draw a line with the pen.
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 |