Pen::SetDashPattern, méthode (gdipluspen.h)
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 |