Fonction PatBlt (wingdi.h)

Article
08/27/2023

La fonction PatBlt peint le rectangle spécifié à l’aide du pinceau actuellement sélectionné dans le contexte d’appareil spécifié. La couleur du pinceau et la ou les couleurs de surface sont combinées à l’aide de l’opération raster spécifiée.

Syntaxe

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] x

Coordonnée x, en unités logiques, du coin supérieur gauche du rectangle à remplir.

[in] y

Coordonnée y, en unités logiques, du coin supérieur gauche du rectangle à remplir.

[in] w

Largeur, en unités logiques, du rectangle.

[in] h

Hauteur, en unités logiques, du rectangle.

[in] rop

Code de l’opération raster. Ce code peut être l’une des valeurs suivantes.

Valeur	Signification
PATCOPY	Copie le modèle spécifié dans l’image bitmap de destination.
PATINVERT	Combine les couleurs du motif spécifié avec les couleurs du rectangle de destination à l’aide de l’opérateur XOR booléen.
DSTINVERT	Inverse le rectangle de destination.
NOIRCEUR	Remplit le rectangle de destination à l’aide de la couleur associée à l’index 0 dans la palette physique. (Cette couleur est le noir sur la palette physique par défaut.)
BLANCHEUR	Remplit le rectangle de destination à l’aide de la couleur associée à l’index 1 dans la palette physique. (Cette couleur est le blanc sur la palette physique par défaut.)

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

Les valeurs du paramètre dwRop pour cette fonction sont un sous-ensemble limité des 256 codes d’opération ternaires complets ; en particulier, un code d’opération qui fait référence à un rectangle source ne peut pas être utilisé.

Tous les appareils ne prennent pas en charge la fonction PatBlt . Pour plus d’informations, consultez la description de la fonctionnalité de RC_BITBLT dans la fonction GetDeviceCaps .

Exemples

Pour obtenir un exemple, consultez « Exemple de Menu-Item bitmaps » dans Utilisation des menus.

Configuration requise


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

Fonctions brush

Vue d’ensemble des pinceaux

GetDeviceCaps

Partager via