Fonction ExtFloodFill (wingdi.h)

Article
08/27/2023

La fonction ExtFloodFill remplit une zone de la surface d’affichage avec le pinceau actuel.

Syntaxe

BOOL ExtFloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color,
  [in] UINT     type
);

Paramètres

[in] hdc

Handle d'un contexte de périphérique.

[in] x

Coordonnée x, en unités logiques, du point où le remplissage doit commencer.

[in] y

Coordonnée y, en unités logiques, du point où le remplissage doit commencer.

[in] color

Couleur de la limite ou de la zone à remplir. L’interprétation de la couleur dépend de la valeur du paramètre fuFillType . Pour créer une valeur de couleur COLORREF , utilisez la macro RVB .

[in] type

Type d’opération de remplissage à effectuer. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FLOODFILLBORDER	La zone de remplissage est limitée par la couleur spécifiée par le paramètre de couleur . Ce style est identique au remplissage effectué par la fonction FloodFill .
INONDATION REMPLISSAGESURFACE	La zone de remplissage est définie par la couleur spécifiée par la couleur. Le remplissage continue vers l’extérieur dans toutes les directions tant que la couleur est rencontrée. Ce style est utile pour remplir les zones avec des limites multicolores.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Voici quelques-unes des raisons pour lesquelles cette fonction peut échouer :

Le remplissage n’a pas pu être terminé.
Le point spécifié a la couleur de limite spécifiée par le paramètre de couleur (si FLOODFILLBORDER a été demandé).
Le point spécifié n’a pas la couleur spécifiée par la couleur (si FLOODFILLSURFACE a été demandé).
Le point se trouve en dehors de la zone de découpage, c’est-à-dire qu’il n’est pas visible sur l’appareil.

Si le paramètre fuFillType est FLOODFILLBORDER, le système suppose que la zone à remplir est entièrement limitée par la couleur spécifiée par le paramètre de couleur . La fonction commence à remplir au point spécifié par les paramètres nXStart et nYStart et continue dans toutes les directions jusqu’à atteindre la limite.

Si fuFillType est FLOODFILLSURFACE, le système suppose que la zone à remplir est d’une couleur unique. La fonction commence à remplir la zone au point spécifié par nXStart et nYStart et continue dans toutes les directions, en remplissant toutes les régions adjacentes contenant la couleur spécifiée par la couleur.

Seuls les contextes de périphériques de mémoire et les appareils qui prennent en charge les opérations d’affichage raster prennent en charge la fonction ExtFloodFill . Pour déterminer si un appareil prend en charge cette technologie, utilisez la fonction GetDeviceCaps .

Exemples

Pour obtenir un exemple, consultez « Ajout de lignes et de graphiques à un menu » dans Utilisation des menus.

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