Método ID2D1RenderTarget::D rawBitmap(ID2D1Bitmap*,constD2D1_RECT_F&,FLOAT,D2D1_BITMAP_INTERPOLATION_MODE,constD2D1_RECT_F*) (d2d1.h)

Desenha o bitmap especificado depois de dimensioná-lo para o tamanho do retângulo especificado.

Sintaxe

void DrawBitmap(
  [in]           ID2D1Bitmap                    *bitmap,
  [ref]          const D2D1_RECT_F &            destinationRectangle,
                 FLOAT                          opacity,
                 D2D1_BITMAP_INTERPOLATION_MODE interpolationMode,
  [in, optional] const D2D1_RECT_F              *sourceRectangle
);

Parâmetros

[in] bitmap

Tipo: ID2D1Bitmap*

O bitmap a ser renderizado.

[ref] destinationRectangle

Tipo: const D2D1_RECT_F

O tamanho e a posição, em pixels independentes do dispositivo no espaço de coordenadas do destino de renderização, da área para a qual o bitmap é desenhado. Se o retângulo não estiver bem ordenado, nada será desenhado, mas o destino de renderização não entrará em estado de erro.

opacity

Tipo: FLOAT

Um valor entre 0,0f e 1,0f, inclusive, que especifica o valor de opacidade a ser aplicado ao bitmap; esse valor é multiplicado em relação aos valores alfa do conteúdo do bitmap. O padrão é 1,0f.

interpolationMode

Tipo: D2D1_BITMAP_INTERPOLATION_MODE

O modo de interpolação a ser usado, se o bitmap for dimensionado ou girado pela operação de desenho. O valor padrão é D2D1_BITMAP_INTERPOLATION_MODE_LINEAR.

[in, optional] sourceRectangle

Tipo: const D2D1_RECT_F*

O tamanho e a posição, em pixels independentes do dispositivo no espaço de coordenadas do bitmap, da área dentro do bitmap a ser desenhado; NULL para desenhar todo o bitmap.

Retornar valor

Nenhum

Comentários

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como DrawBitmap) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Exemplos

Para obter um exemplo, consulte Como desenhar um bitmap. Para obter um exemplo que mostra como carregar um bitmap de um recurso ou de um arquivo, consulte Como carregar um Bitmap de um recurso e Como carregar um bitmap de um arquivo.

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

Confira também

ID2D1RenderTarget