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 |