Compartilhar via


Método ID2D1DeviceContext::GetImageWorldBounds (d2d1_1.h)

Obtém os limites de uma imagem com a transformação mundial do contexto aplicado.

Sintaxe

HRESULT GetImageWorldBounds(
  [in]  ID2D1Image  *image,
  [out] D2D1_RECT_F *worldBounds
);

Parâmetros

[in] image

Tipo: ID2D1Image*

A imagem cujos limites serão calculados.

[out] worldBounds

Tipo: D2D1_RECT_F[1]

Quando esse método retorna, contém um ponteiro para os limites da imagem em DIPs (pixels independentes do dispositivo).

Valor retornado

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT Descrição
S_OK Não ocorreu nenhum erro.
E_OUTOFMEMORY O Direct2D não pôde alocar memória suficiente para concluir a chamada.
E_INVALIDARG Um parâmetro inválido foi passado para a função de retorno.

Comentários

Os limites de imagem refletem a DPI atual, o modo de unidade e a transformação do mundo do contexto. Para obter limites que não incluem a transformação mundial, use ID2D1DeviceContext::GetImageLocalBounds.

Os limites retornados refletem quais pixels seriam afetados chamando DrawImage com a mesma imagem e um deslocamento de destino de (0,0). Eles não refletem o retângulo de clipe atual definido no contexto do dispositivo ou a extensão da imagem de destino atual do contexto.

Requisitos

   
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
DLL D2d1.dll

Confira também

D2D1_RECT_F

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::GetImageLocalBounds

ID2D1Image