Metodo Pen::SetDashStyle (gdipluspen.h)

Articolo
02/26/2024

Il metodo Pen::SetDashStyle imposta lo stile trattino per questo oggetto Pen .

Sintassi

Status SetDashStyle(
  [in] DashStyle dashStyle
);

Parametri

[in] dashStyle

Tipo: DashStyle

Elemento dell'enumerazione DashStyle che specifica lo stile trattino per questo oggetto Pen .

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

La lunghezza dei trattini in una linea tratteggiata dipende dallo stile del trattino e dalla larghezza dell'oggetto Pen . La lunghezza dello spazio che separa due trattini in una linea tratteggiata è uguale alla larghezza dell'oggetto Pen .

Esempio

L'esempio seguente crea un oggetto Pen , imposta lo stile del trattino e disegna una linea. Il codice reimposta quindi lo stile del trattino, disegna una seconda riga, reimposta nuovamente lo stile del trattino e disegna una terza riga.

VOID Example_SetDashStyle(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 255), 15);

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

Requisiti

Requisito	Valore
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