Partager via


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

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

Voir aussi

Dessin d’une ligne pointillée personnalisée

Stylet

Pen::GetDashPatternCount

Pen::SetDashPattern

Stylos, lignes et rectangles