Função SetROP2 (wingdi.h)

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