Pen ::SetDashOffset, méthode (gdipluspen.h)

Article
02/26/2024

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