Partager via


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

Voir aussi

Dessin d’une ligne en pointillés personnalisée

Stylet

Pen ::GetDashOffset

Pen ::GetDashPattern

Pen ::GetDashPatternCount

Pen ::GetDashStyle

Pen ::SetDashCap

Pen ::SetDashPattern

Pen ::SetDashStyle

Stylos, lignes et rectangles