Método Graphics::D rawCachedBitmap (gdiplusgraphics.h)

O método Graphics::D rawCachedBitmap desenha a imagem armazenada em um objeto CachedBitmap .

Sintaxe

Status DrawCachedBitmap(
  [in] CachedBitmap *cb,
  [in] INT          x,
  [in] INT          y
);

Parâmetros

[in] cb

Tipo: CachedBitmap*

Ponteiro para um objeto CachedBitmap que contém a imagem a ser desenhada.

[in] x

Tipo: INT

Inteiro que especifica a coordenada x do canto superior esquerdo da imagem.

[in] y

Tipo: INT

Inteiro que especifica a coordenada y do canto superior esquerdo da imagem.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Um objeto CachedBitmap armazena uma imagem em um formato otimizado para uma tela de exibição específica. Não é possível desenhar um bitmap armazenado em cache para uma impressora ou para um metarquivo.

Bitmaps armazenados em cache não funcionarão com transformações diferentes da tradução.

Ao construir um objeto CachedBitmap , você deve passar o endereço de um objeto Graphics para o construtor. Se a tela associada a esse objeto Graphics tiver sua profundidade de bit alterada depois que o bitmap armazenado em cache for construído, o método Graphics::D rawCachedBitmap falhará e você deverá reconstruir o bitmap armazenado em cache. Como alternativa, você pode conectar a mensagem de notificação de alteração de exibição e reconstruir o bitmap armazenado em cache nesse momento.

Exemplos

O exemplo a seguir chama Graphics::D rawCachedBitmap para desenhar a imagem armazenada em um objeto CachedBitmap .

VOID Example_DrawCachedBitmap(HDC hdc)
{
   Graphics graphics(hdc);

   // Create Bitmap object.
   Bitmap bitmap(L"Climber.jpg");

   // Use the Bitmap object to create a CachedBitmap object.
   CachedBitmap cachedBitmap(&bitmap, &graphics);

   // Draw the cached bitmap.
   graphics.DrawCachedBitmap(&cachedBitmap, 20, 10);
}

Requisitos

Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Bitmap

Desenhar, posicionar e clonar imagens

Elementos gráficos

Usando um Bitmap armazenado em cache para melhorar o desempenho