Pen::SetCompoundArray-Methode (gdipluspen.h)

Artikel
08/24/2023

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