Metodo Pen::SetDashOffset (gdipluspen.h)
Il metodo Pen::SetDashOffset imposta la distanza dall'inizio della riga all'inizio del primo trattino in una linea tratteggiata.
Sintassi
Status SetDashOffset(
[in] REAL dashOffset
);
Parametri
[in] dashOffset
Tipo: REAL
Numero reale che specifica il numero di volte in cui spostare gli spazi in una linea tratteggiata. Ogni spostamento è uguale alla lunghezza di uno spazio nella linea tratteggiata.
Valore restituito
Tipo: Stato
Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .
Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .
Commenti
Un valore dashOffset positivo sposta il primo trattino avanti lungo il percorso e un valore dashOffset negativo sposta l'inizio del percorso avanti lungo il primo trattino.
Esempio
L'esempio seguente crea un oggetto Pen , imposta lo stile del trattino e disegna una linea. Il codice imposta quindi il valore di offset della penna e disegna una seconda riga.
VOID Example_SetDashOffset(HDC hdc)
{
Graphics graphics(hdc);
// Create a Pen object, set the dash style, and draw a line.
Pen pen(Color(255, 0, 0, 255), 15);
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 50, 400, 50);
// Set the dash offset value for the pen, and draw a second line.
pen.SetDashOffset(10);
graphics.DrawLine(&pen, 0, 80, 400, 80);
}
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 |