Méthode Pen::SetCompoundArray (gdipluspen.h)

Article
08/24/2023

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