Metodo Pen::SetCompoundArray (gdipluspen.h)

Articolo
08/24/2023

Il metodo Pen::SetCompoundArray imposta la matrice composta per questo oggetto Pen .

Sintassi

Status SetCompoundArray(
  [in] const REAL *compoundArray,
  [in] INT        count
);

Parametri

[in] compoundArray

Tipo: const REAL*

Puntatore a una matrice di numeri reali che specifica la matrice composta. Gli elementi della matrice devono essere in ordine crescente, non minori di 0 né maggiori di 1.

[in] count

Tipo: INT

Numero intero positivo che specifica il numero di elementi nella matrice compoundArray . L'intero non deve essere maggiore del numero di elementi nella matrice composta.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Si supponga di voler disegnare due linee parallele in cui la larghezza della prima riga è il 20% della larghezza della penna, la larghezza dello spazio che separa le due righe è il 50% della larghezza della penna e la larghezza della seconda riga è il 30% della larghezza della penna. Iniziare creando un oggetto Pen e una matrice di numeri reali. È quindi possibile impostare la matrice composta passando la matrice con i valori 0.0, 0.2, 0.7 e 1.0 al metodo Pen::SetCompoundArray dell'oggetto Pen .

Se si imposta l'allineamento di un oggetto Pensu PenAlignmentInset, non è possibile usare tale penna per disegnare linee composte.

Esempio

Nell'esempio seguente viene creato un oggetto Pen e viene impostata la matrice composta per la penna. Il codice disegna quindi una riga usando l'oggetto Pen .

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);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdipluspen.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll