Função SetROP2 (wingdi.h)

  • Artigo

A função SetROP2 define o modo de combinação de primeiro plano atual. A GDI usa o modo de combinação de primeiro plano para combinar canetas e interiores de objetos preenchidos com as cores já na tela. O modo de combinação em primeiro plano define como as cores do pincel ou da caneta e as cores na imagem existente devem ser combinadas.

Sintaxe

int SetROP2(
  [in] HDC hdc,
  [in] int rop2
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] rop2

O modo de combinação. Esse parâmetro pode usar um dos valores a seguir.

Modo de combinação Significado
R2_BLACK
 Pixel é sempre 0.
R2_COPYPEN
 O pixel é da cor da caneta.
R2_MASKNOTPEN
 Pixel é uma combinação das cores comuns à tela e ao inverso da caneta.
R2_MASKPEN
 Pixel é uma combinação das cores comuns à caneta e à tela.
R2_MASKPENNOT
 Pixel é uma combinação das cores comuns à caneta e ao inverso da tela.
R2_MERGENOTPEN
 Pixel é uma combinação da cor da tela e do inverso da cor da caneta.
R2_MERGEPEN
 Pixel é uma combinação da cor da caneta e da cor da tela.
R2_MERGEPENNOT
 Pixel é uma combinação da cor da caneta e do inverso da cor da tela.
R2_NOP
 O pixel permanece inalterado.
R2_NOT
 O pixel é o inverso da cor da tela.
R2_NOTCOPYPEN
 O pixel é o inverso da cor da caneta.
R2_NOTMASKPEN
 Pixel é o inverso da cor R2_MASKPEN.
R2_NOTMERGEPEN
 Pixel é o inverso da cor R2_MERGEPEN.
R2_NOTXORPEN
 Pixel é o inverso da cor R2_XORPEN.
R2_WHITE
 Pixel é sempre 1.
R2_XORPEN
 Pixel é uma combinação das cores na caneta e na tela, mas não em ambos.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará o modo de combinação anterior.

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

Comentários

Os modos de combinação definem como o GDI combina as cores de origem e destino ao desenhar com a caneta atual. Os modos de combinação são códigos de operação de raster binários, representando todas as possíveis funções boolianas de duas variáveis, usando as operações binárias AND, OR e XOR (OR exclusivo) e a operação unária NOT. O modo de combinação é apenas para dispositivos raster; ele não está disponível para dispositivos vetoriais.

Exemplos

Para obter um exemplo, consulte Usando retângulos.

Requisitos

Requisito Valor
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

GetROP2

Funções de pintura e desenho

Visão geral de pintura e desenho