CDC::BitBlt 

BOOL BitBlt( int x, int y, int nWidth, int nHeight, CDC* pSrcDC, int xSrc, int ySrc, DWORD dwRop );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

x

Especifica o x lógica-coordenar de upper-Esquerda canto do Retangular de destino.

y

Especifica a y lógica-coordenar de upper-Esquerda canto do Retangular de destino.

nWidth

Especifica a largura (nas unidades lógicas) do destino Retangular e origem de bitmap.

nHeight

Especifica a altura (em unidades lógicas) do destino Retangular e origem de bitmap.

pSrcDC

Ponteiro para um objeto de CDC que identifica o contexto de dispositivo do qual o bitmap será copiado. Ele deve ser NULL se dwRop especifica uma operação de varredura que não inclui uma origem.

xSrc

Especifica o x lógica-coordenar de upper-Esquerda canto of the bitmap origem.

ySrc

Especifica a y lógica-coordenar de upper-Esquerda canto of the bitmap origem.

dwRop

Especifica a operação de varredura a ser executada. Códigos de operação de varredura definem como a GDI combina cores nas operações de saída que envolvem um pincel atual, uma possível origem de bitmap e um bitmap de destino. Os seguintes listas de códigos de operação de varredura para dwRop e suas descrições:

Para obter uma lista completa dos códigos de operação de varredura, consulte sobre códigos operação de varredura na seção apêndices da Referência do programador do Win32 SDK.

Observações

Cópias a bitmap from the contexto dispositivo origem to neste contexto de dispositivo atual.

O aplicativo pode alinhar as janelas ou áreas de cliente em limites de byte para garantir que ocorrem as operações de BitBlt em retângulos alinhados byte. (Definir os CS_BYTEALIGNWINDOW ou CS_BYTEALIGNCLIENT sinalizadores ao registrar as classes de janela.)

Operações de BitBlt em retângulos alinhados byte são consideravelmente mais rápido do que operações de BitBlt em retângulos que não estão alinhado byte. Se você quiser especificar estilos de classe, como o alinhamento de byte para seu próprio contexto de dispositivo, você precisará registrar uma classe de janela em vez de depender Microsoft Foundation classes para fazer isso por você. Use a função global do AfxRegisterWndClass.

GDI transforma nWidth e nHeight, uma usando o contexto de dispositivo de destino e uma vez usando o contexto de dispositivo de origem. Se as extensões resultantes não coincidirem, GDI usa a função Windows StretchBlt para comprimir ou alongar o bitmap de origem conforme necessário.

Se destino, origem e bitmaps padrão não tiver o mesmo formato cor, a função BitBlt converte os bitmaps de origem e o padrão para coincidir com o destino. As cores do primeiro plano e plano de fundo do bitmap destino são usadas na conversão.

Quando a função BitBlt converte um bitmap monocromático para cor, ele define branco bits (1) para a cor de fundo e bits preto (0) para a cor de primeiro plano. As cores do primeiro plano e segundo plano do contexto de dispositivo de destino são usadas. Para converter cores em monocromático, BitBlt define pixels que correspondem a cor do plano de fundo para branco e define tudo outro pixels para preto. BitBlt usa as cores do primeiro plano e segundo plano do contexto de dispositivo de cores para converter cores em monocromático.

Observe que nem todos os contextos de dispositivo oferecer suporte a BitBlt. Para verificar se um contexto de determinado dispositivo oferece suporte a BitBlt, use a função de membro GetDeviceCaps e especifique o índice RASTERCAPS.

Visão geral do CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC:: GetDeviceCaps, CDC::PatBlt, CDC::SetTextColor, CDC:: StretchBlt, :: StretchDIBits, :: BitBlt

Index