CDC::BitBlt

Artigo
08/25/2010

Copia um bitmap do contexto de dispositivo de origem para este contexto de dispositivo atual.

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

Parâmetros

x
Especifica a lógica coordenada x do canto superior Esquerda canto do Retangular de destino.
y
Especifica a lógica coordenada y do canto superior 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 para dispositivo do qual o bitmap será copiado.Ele deve ser NULL se dwRop Especifica uma operação de varredura não Incluir uma Origem.
xSrc
Especifica a lógica coordenada x do canto superior Esquerda canto do bitmap de origem.
ySrc
Especifica a lógica coordenada y do canto superior Esquerda canto do bitmap de origem.
dwRop
Especifica a operação de varredura a ser executada.Códigos de operação de varredura Definirm como a GDI combina cores em operações de saída que envolvem um pincel atual, um bitmap de origem possíveis e um bitmap de destino.Consulte BitBlt in the Windows SDK para obter uma lista dos 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 de operação de varredura in the Windows SDK.

Valor de retorno

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

Comentários

O aplicativo pode alinhar o windows ou áreas de cliente em limites de byte para garantir que as operações de BitBlt ocorra em retângulos alinhados byte.(Defina a CS_BYTEALIGNWINDOW ou CS_BYTEALIGNCLIENT sinalizadores ao registrar as classes de janela.)

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

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

Se o destino, origem e bitmaps padrão não tiver o mesmo Formatarar de cor, a função BitBlt converte os bitmaps de origem e o padrão para coincidir com o destino.As cores de 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 do plano de fundo e bits preto (0) para a Cor do primeiro plano.As cores de primeiro plano e plano de fundo 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 de primeiro plano e plano de fundo do contexto de dispositivo da cor para converter de cor em monocromático.

Anotação que nem Tudo contextos de dispositivo oferecem suporte a BitBlt.Para Marcar se um contexto de determinado dispositivo dá suporte a BitBlt, use a função de membro GetDeviceCaps e especifique o índice de RASTERCAPS.