Metodo Pen::GetDashPattern (gdipluspen.h)

Articolo
08/24/2023

Il metodo Pen::GetDashPattern ottiene una matrice di trattini e spazi personalizzati attualmente impostati per questo oggetto Pen .

Sintassi

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

Parametri

[out] dashArray

Tipo: REAL*

Puntatore a una matrice che riceve la lunghezza dei trattini e degli spazi in una linea tratteggiata personalizzata.

[in] count

Tipo: INT

Intero che specifica il numero di elementi nella matrice dashArray .

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

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 di ogni elemento nella matrice e la larghezza dell'oggetto Pen .

Esempio

L'esempio seguente crea una matrice di numeri reali e un oggetto Penna , imposta il modello trattino e disegna una linea tratteggiata personalizzata. Il codice ottiene quindi il modello trattino attualmente impostato per la penna.

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

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