Fonction SetPolyFillMode (wingdi.h)

La fonction SetPolyFillMode définit le mode de remplissage des polygones pour les fonctions qui remplissent les polygones.

Syntaxe

int SetPolyFillMode(
  [in] HDC hdc,
  [in] int mode
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] mode

Nouveau mode de remplissage. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
ALTERNATIVE	Sélectionne un autre mode (remplit la zone entre les côtés des polygones impairs et pairs sur chaque ligne de balayage).
ENROULEMENT	Sélectionne le mode de remontage (remplit n’importe quelle région avec une valeur de remontage différente de zéro).

Valeur retournée

La valeur de retour spécifie le mode de remplissage précédent. Si une erreur se produit, la valeur de retour est zéro.

Remarques

En général, les modes diffèrent uniquement dans les cas où un polygone complexe qui se chevauche doit être rempli (par exemple, un polygone à cinq faces qui forme un star à cinq branches avec un pentagone au centre). Dans ce cas, le mode ALTERNATE remplit toutes les autres régions fermées dans le polygone (c’est-à-dire les points du star), mais le mode WINDING remplit toutes les régions (c’est-à-dire les points et le pentagone).

Lorsque le mode de remplissage est ALTERNATE, GDI remplit la zone entre les côtés des polygones impairs et pairs sur chaque ligne de balayage. Autrement dit, GDI remplit la zone entre le premier et le deuxième côté, entre le troisième et le quatrième côté, et ainsi de suite.

Lorsque le mode de remplissage est WINDING, GDI remplit toute région qui a une valeur de remontage différente de zéro. Cette valeur est définie comme le nombre de fois où un stylet utilisé pour dessiner le polygone est utilisé dans la région. La direction de chaque bord du polygone est importante.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	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	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

GetPolyFillMode

Fonctions de région

Vue d’ensemble des régions