Méthode Pen::SetCompoundArray (gdipluspen.h)
La méthode Pen::SetCompoundArray définit le tableau composé pour cet objet Pen .
Syntaxe
Status SetCompoundArray(
[in] const REAL *compoundArray,
[in] INT count
);
Paramètres
[in] compoundArray
Type : const REAL*
Pointeur vers un tableau de nombres réels qui spécifie le tableau composé. Les éléments du tableau doivent être dans l'ordre croissant, supérieurs à 0 et inférieurs à 1.
[in] count
Type : INT
Entier pair positif qui spécifie le nombre d’éléments dans le tableau compoundArray . L’entier ne doit pas être supérieur au nombre d’éléments dans le tableau composé.
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
Supposons qu’un stylet dessine deux lignes parallèles où la largeur de la première ligne est de 20 % de la largeur du stylet, la largeur de l’espace qui sépare les deux lignes est de 50 % de la largeur du stylet et la largeur de la deuxième ligne est de 30 % de la largeur du stylet. Commencez par créer un objet Pen et un tableau de nombres réels. Vous pouvez ensuite définir le tableau composé en transmettant le tableau avec les valeurs 0.0, 0.2, 0.7 et 1.0 à la méthode Pen::SetCompoundArray de l’objet Pen .
Si vous définissez l’alignement d’un objet Pen sur PenAlignmentInset, vous ne pouvez pas utiliser ce stylet pour dessiner des lignes composées.
Exemples
L’exemple suivant crée un objet Pen et définit le tableau composé pour le stylet. Le code dessine ensuite une ligne à l’aide de l’objet Pen .
VOID Example_SetCompoundArray(HDC hdc)
{
Graphics graphics(hdc);
// Create an array of real numbers and a Pen object.
REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
Pen pen(Color(255, 0, 0, 255), 30);
// Set the compound array of the pen.
pen.SetCompoundArray(compVals, 6);
// Draw a line with the pen.
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 (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |