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

Article
08/24/2023

La méthode Pen::SetDashPattern définit un tableau de tirets et d’espaces personnalisés pour cet objet Pen .

Syntaxe

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

Paramètres

[in] dashArray

Type : const REAL*

Pointeur vers un tableau de nombres réels qui spécifie la longueur des tirets et espaces personnalisés. Tous les éléments du tableau doivent être des nombres réels positifs.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments dans le tableau dashArray . L’entier doit être supérieur à 0 et ne doit pas être supérieur au nombre total d’éléments dans le tableau.

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 .

Notes

Cette méthode définit l’énumération DashStyle pour cet objet stylet sur DashStyleCustom.

Les éléments du tableau dashArray définissent la longueur de chaque tiret et l’espace dans le modèle de tiret. Le premier élément définit la longueur d’un tiret, le deuxième élément définit la longueur d’un espace, le troisième élément définit la longueur d’un tiret, etc.

La longueur de chaque tiret et espace dans le motif de tiret est le produit de la valeur de l’élément dans le tableau et de la largeur de l’objet Pen .

Exemples

L’exemple suivant crée un tableau de nombres réels. Le code crée ensuite un objet Pen , définit le motif de tiret en fonction du tableau, puis dessine la ligne en pointillés personnalisée.

VOID Example_SetDashPattern(HDC hdc)
{
   Graphics graphics(hdc);

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 0), 5);

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

Configuration requise


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