Metodo Pen::SetDashPattern (gdipluspen.h)

Articolo
08/24/2023

Il metodo Pen::SetDashPattern imposta una matrice di trattini e spazi personalizzati per questo oggetto Pen .

Sintassi

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

Parametri

[in] dashArray

Tipo: const REAL*

Puntatore a una matrice di numeri reali che specifica la lunghezza dei trattini e degli spazi personalizzati. Tutti gli elementi della matrice devono essere numeri reali positivi.

[in] count

Tipo: INT

Intero che specifica il numero di elementi nella matrice dashArray . L'intero deve essere maggiore di 0 e non maggiore del numero totale di elementi nella matrice.

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

Questo metodo imposta l'enumerazione DashStyle per questo oggetto Pen su DashStyleCustom.

Gli elementi della matrice dashArray impostano la lunghezza di ogni trattino e spazio nel modello trattino. Il primo elemento imposta la lunghezza di un trattino, il secondo elemento imposta la lunghezza di uno spazio, il terzo elemento imposta la lunghezza di un trattino e così via.

La lunghezza di ogni trattino e spazio nel modello trattino è il prodotto del valore dell'elemento nella matrice e della larghezza dell'oggetto Pen .

Esempio

Nell'esempio seguente viene creata una matrice di numeri reali. Il codice crea quindi un oggetto Pen , imposta il modello trattino in base alla matrice e quindi disegna la linea tratteggiata personalizzata.

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

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