Método ID2D1Bitmap::CopyFromBitmap (d2d1.h)

Copia la región especificada del mapa de bits especificado en el mapa de bits actual.

Sintaxis

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Parámetros

[in, optional] destPoint

Tipo: const D2D1_POINT_2U*

En el mapa de bits actual, la esquina superior izquierda del área a la que se copia la región especificada por srcRect .

[in] bitmap

Tipo: ID2D1Bitmap*

Mapa de bits desde el que se va a copiar.

[in, optional] srcRect

Tipo: const D2D1_RECT_U*

Área del mapa de bits que se va a copiar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Este método no actualiza el tamaño del mapa de bits actual. Si el contenido del mapa de bits de origen no cabe en el mapa de bits actual, se produce un error en este método. Además, tenga en cuenta que este método no realiza la conversión de formato y producirá un error si los formatos de mapa de bits no coinciden.

Llamar a este método puede hacer que el lote actual se vacíe si el mapa de bits está activo en el lote. Si el lote que se ha vaciado no se completa correctamente, se produce un error en este método. Sin embargo, este método no borra el estado de error del destino de representación en el que se ha vaciado el lote. El estado hrESULT y etiqueta con errores se devolverá en la siguiente llamada a EndDraw o Flush.

A partir de Windows 8.1, este método admite mapas de bits comprimidos en bloques. Si usa un formato comprimido de bloque, las coordenadas finales del parámetro srcRect deben ser múltiplo de 4 o el método devuelve E_INVALIDARG.

Requisitos

Consulte también

ID2D1Bitmap