Pen ::SetDashOffset, méthode (gdipluspen.h)
La méthode Pen ::SetDashOffset définit la distance entre le début de la ligne et le début du premier tiret d’une ligne en pointillés.
Syntaxe
Status SetDashOffset(
[in] REAL dashOffset
);
Paramètres
[in] dashOffset
Type : REAL
Nombre réel qui spécifie le nombre de fois où déplacer les espaces d’une ligne en pointillés. Chaque décalage est égal à la longueur d’un espace dans la ligne en pointillés.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Remarques
Une valeur dashOffset positive déplace le premier tiret vers l’avant le long du chemin, et une valeur dashOffset négative déplace le début du chemin vers l’avant le long du premier tiret.
Exemples
L’exemple suivant crée un objet Pen , définit le style de tiret et dessine une ligne. Le code définit ensuite la valeur de décalage du stylet et dessine une deuxième ligne.
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);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdipluspen.h (include Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |