Partager via


Méthode Pen ::SetDashStyle (gdipluspen.h)

La méthode Pen ::SetDashStyle définit le style de tiret de cet objet Pen .

Syntaxe

Status SetDashStyle(
  [in] DashStyle dashStyle
);

Paramètres

[in] dashStyle

Type : DashStyle

Élément de l’énumération DashStyle qui spécifie le style de tiret pour cet objet Stylet .

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

La longueur des tirets d’une ligne pointillée dépend du style de tiret et de la largeur de l’objet Stylet . La longueur de l’espace qui sépare deux tirets dans une ligne pointillée est égale à la largeur de l’objet Pen .

Exemples

L’exemple suivant crée un objet Pen , définit le style de tiret et dessine une ligne. Le code réinitialise ensuite le style de tiret, dessine une deuxième ligne, réinitialise à nouveau le style de tiret et dessine une troisième ligne.

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

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 (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Dessin d’une ligne pointillée personnalisée

Stylet

Pen ::GetDashCap

Pen ::GetDashOffset

Pen ::GetDashPattern

Pen ::GetDashPatternCount

Stylet ::GetDashStyle

Pen ::SetDashCap

Pen ::SetDashOffset

Pen ::SetDashPattern

Stylos, lignes et rectangles