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

Article
08/24/2023

La méthode Pen::GetDashPattern obtient un tableau de tirets et d’espaces personnalisés actuellement définis pour cet objet Pen .

Syntaxe

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

Paramètres

[out] dashArray

Type : REAL*

Pointeur vers un tableau qui reçoit la longueur des tirets et des espaces d’une ligne pointillée personnalisée.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments dans le tableau dashArray .

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

Les éléments du tableau dashArray définissent la longueur de chaque tiret et l’espace dans le motif 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, et ainsi de suite.

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

Exemples

L’exemple suivant crée un tableau de nombres réels et un objet Pen , définit le motif de tiret et dessine une ligne pointillée personnalisée. Le code obtient ensuite le motif de tiret actuellement défini pour le stylet.

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

Spécifications


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