Fonction PatBlt (wingdi.h)

  • Article

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