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

Article
03/01/2024

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