Método IWICImagingFactory::CreateBitmapFromSourceRect (wincodec.h)

Cria um IWICBitmap de um retângulo especificado de um IWICBitmapSource.

Sintaxe

HRESULT CreateBitmapFromSourceRect(
  [in]  IWICBitmapSource *pIBitmapSource,
  [in]  UINT             x,
  [in]  UINT             y,
  [in]  UINT             width,
  [in]  UINT             height,
  [out] IWICBitmap       **ppIBitmap
);

Parâmetros

[in] pIBitmapSource

Tipo: IWICBitmapSource*

O IWICBitmapSource do qual criar o bitmap.

[in] x

Tipo: UINT

A coordenada horizontal do canto superior esquerdo do retângulo.

[in] y

Tipo: UINT

A coordenada vertical do canto superior esquerdo do retângulo.

[in] width

Tipo: UINT

A largura do retângulo e o novo bitmap.

[in] height

Tipo: UINT

A altura do retângulo e o novo bitmap.

[out] ppIBitmap

Tipo: IWICBitmap**

Um ponteiro que recebe um ponteiro para o novo bitmap.

Valor retornado

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

Fornecer um retângulo maior que a origem produzirá resultados indefinidos.

Esse método sempre cria uma cópia separada da imagem de origem, semelhante à opção de cache WICBitmapCacheOnLoad.

Requisitos

Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll