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 |