Função EngCopyBits (winddi.h)

A função EngCopyBits é convertida entre superfícies de raster gerenciadas pelo dispositivo e bitmaps de formato padrão GDI.

Sintaxe

ENGAPI BOOL EngCopyBits(
       SURFOBJ  *psoDest,
       SURFOBJ  *psoSrc,
       CLIPOBJ  *pco,
       XLATEOBJ *pxlo,
  [in] RECTL    *prclDest,
  [in] POINTL   *pptlSrc
);

Parâmetros

psoDest

Ponteiro para uma estrutura SURFOBJ que descreve a superfície de destino da operação de cópia.

psoSrc

Ponteiro para uma estrutura SURFOBJ que descreve a superfície de origem da operação de cópia.

pco

Ponteiro para uma estrutura CLIPOBJ que restringe a área da superfície de destino que será afetada. Este parâmetro pode ser NULL.

pxlo

Ponteiro para uma estrutura XLATEOBJ que define a tradução de índices de cores entre as superfícies de origem e de destino.

[in] prclDest

Ponteiro para uma estrutura RECTL que define a área no sistema de coordenadas da superfície de destino que será modificada. O retângulo é exclusivo para o canto inferior direito, o que significa que as bordas inferior e direita desse retângulo não fazem parte da cópia.

[in] pptlSrc

Ponteiro para uma estrutura POINTL que define o canto superior esquerdo do retângulo de origem.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida. Se não for bem-sucedido, ele registrará um erro e retornará FALSE.

Comentários

Os bitmaps de formato padrão são um formato de plano único, de pixels empacotados. Cada linha de verificação é alinhada em um limite de 4 bytes. Esses bitmaps têm 1, 4, 8, 16, 24 ou 32 bits por pixel. Consulte a função EngCreateBitmap para obter uma lista de tipos de formato padrão.

A GDI chama essa função de suas simulações.

EngCopyBits não deve ser chamado com um retângulo de destino vazio e os dois pontos do retângulo de destino devem ser bem ordenados; ou seja, o primeiro ponto deve representar o vértice superior esquerdo do retângulo e o segundo deve representar o vértice inferior direito.

Requisitos

Confira também

CLIPOBJ

SURFOBJ

XLATEOBJ