Método ID2D1Bitmap::CopyFromBitmap (d2d1.h)
Copia a região especificada do bitmap especificado no bitmap atual.
Sintaxe
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*
No bitmap atual, o canto superior esquerdo da área para a qual a região especificada por srcRect é copiada.
[in] bitmap
Tipo: ID2D1Bitmap*
O bitmap a partir do qual copiar.
[in, optional] srcRect
Tipo: const D2D1_RECT_U*
A área de bitmap a ser copiada .
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
Esse método não atualiza o tamanho do bitmap atual. Se o conteúdo do bitmap de origem não se ajustar ao bitmap atual, esse método falhará. Além disso, observe que esse método não executa a conversão de formato e falhará se os formatos de bitmap não corresponderem.
Chamar esse método pode fazer com que o lote atual seja liberado se o bitmap estiver ativo no lote. Se o lote que foi liberado não for concluído com êxito, esse método falhará. No entanto, esse método não limpa o estado de erro do destino de renderização no qual o lote foi liberado. O HRESULT com falha e o estado da marca serão retornados na próxima chamada para EndDraw ou Flush.
Começando com Windows 8.1, esse método dá suporte a bitmaps compactados em bloco. Se você estiver usando um formato compactado em bloco, as coordenadas finais do parâmetro srcRect deverão ser múltiplas de 4 ou o método retornará E_INVALIDARG.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d2d1.h |
| Biblioteca | D2d1.lib |
| DLL | D2d1.dll |