Função PatBlt (wingdi.h)

  • Artigo

A função PatBlt pinta o retângulo especificado usando o pincel que está selecionado no contexto do dispositivo especificado. A cor do pincel e a cor ou as cores da superfície são combinadas usando a operação de raster especificada.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo a ser preenchido.

[in] y

A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo a ser preenchido.

[in] w

A largura, em unidades lógicas, do retângulo.

[in] h

A altura, em unidades lógicas, do retângulo.

[in] rop

O código de operação de raster. Esse código pode ser um dos valores a seguir.

Valor Significado
PATCOPY
 Copia o padrão especificado no bitmap de destino.
PATINVERT
 Combina as cores do padrão especificado com as cores do retângulo de destino usando o operador XOR booliano.
DSTINVERT
 Inverte o retângulo de destino.
ESCURIDÃO
 Preenche o retângulo de destino usando a cor associada ao índice 0 na paleta física. (Essa cor é preta para a paleta física padrão.)
BRANCURA
 Preenche o retângulo de destino usando a cor associada ao índice 1 na paleta física. (Essa cor é branca para a paleta física padrão.)

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Os valores do parâmetro dwRop para essa função são um subconjunto limitado dos 256 códigos de operação de raster ternário completos; em particular, um código de operação que se refere a um retângulo de origem não pode ser usado.

Nem todos os dispositivos dão suporte à função PatBlt . Para obter mais informações, consulte a descrição do recurso RC_BITBLT na função GetDeviceCaps .

Exemplos

Para obter um exemplo, consulte "Exemplo de Menu-Item Bitmaps" em Usando menus.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções brush

Visão geral de pincéis

Getdevicecaps