Funzione PatBlt (wingdi.h)

  • Articolo

La funzione PatBlt disegna il rettangolo specificato usando il pennello attualmente selezionato nel contesto di dispositivo specificato. Il colore del pennello e il colore o i colori della superficie vengono combinati usando l'operazione raster specificata.

Sintassi

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

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] x

Coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo da riempire.

[in] y

Coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo da riempire.

[in] w

Larghezza, in unità logiche, del rettangolo.

[in] h

Altezza, in unità logiche, del rettangolo.

[in] rop

Codice dell'operazione raster. Questo codice può essere uno dei valori seguenti.

Valore Significato
PATCOPY
 Copia il modello specificato nella bitmap di destinazione.
PATINVERT
 Combina i colori del motivo specificato con i colori del rettangolo di destinazione usando l'operatore XOR booleano.
DSTINVERT
 Inverte il rettangolo di destinazione.
OSCURITÀ
 Riempie il rettangolo di destinazione usando il colore associato all'indice 0 nella tavolozza fisica. Nella tavolozza fisica predefinita questo colore è il nero.
BIANCHEZZA
 Riempie il rettangolo di destinazione usando il colore associato all'indice 1 nella tavolozza fisica. Nella tavolozza fisica predefinita questo colore è il bianco.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

I valori del parametro dwRop per questa funzione sono un subset limitato dei codici di operazione raster ternari completi 256; in particolare, non è possibile usare un codice operazione che fa riferimento a un rettangolo di origine.

Non tutti i dispositivi supportano la funzione PatBlt . Per altre informazioni, vedere la descrizione della funzionalità di RC_BITBLT nella funzione GetDeviceCaps .

Esempio

Per un esempio, vedere "Esempio di Menu-Item bitmap" in Uso dei menu.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

Funzioni pennello

Panoramica dei pennelli

GetDeviceCaps