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

El método Graphics::D rawCachedBitmap dibuja la imagen almacenada en un objeto CachedBitmap .

Sintaxis

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

Parámetros

[in] cb

Tipo: CachedBitmap*

Puntero a un objeto CachedBitmap que contiene la imagen que se va a dibujar.

[in] x

Tipo: INT

Entero que especifica la coordenada x de la esquina superior izquierda de la imagen.

[in] y

Tipo: INT

Entero que especifica la coordenada y de la esquina superior izquierda de la imagen.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Un objeto CachedBitmap almacena una imagen en un formato optimizado para una pantalla de visualización determinada. No se puede dibujar un mapa de bits almacenado en caché en una impresora o en un metarchivo.

Los mapas de bits almacenados en caché no funcionarán con ninguna transformación distinta de la traducción.

Al construir un objeto CachedBitmap , debe pasar la dirección de un objeto Graphics al constructor. Si la pantalla asociada a ese objeto Graphics ha cambiado su profundidad de bits después de construir el mapa de bits almacenado en caché, se producirá un error en el método Graphics::D rawCachedBitmap y debe reconstruir el mapa de bits almacenado en caché. Como alternativa, puede enlazar el mensaje de notificación de cambio de visualización y reconstruir el mapa de bits almacenado en caché en ese momento.

Ejemplos

En el ejemplo siguiente se llama a Graphics::D rawCachedBitmap para dibujar la imagen almacenada en un 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 compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Bitmap

Dibujo, posicionamiento y clonación de imágenes

Elementos gráficos

Uso de un mapa de bits almacenado en caché para mejorar el rendimiento