Metodo Graphics::D rawCachedBitmap (gdiplusgraphics.h)

Articolo
03/14/2023

Il metodo Graphics::D rawCachedBitmap disegna l'immagine archiviata in un oggetto CachedBitmap .

Sintassi

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

Parametri

[in] cb

Tipo: CachedBitmap*

Puntatore a un oggetto CachedBitmap che contiene l'immagine da disegnare.

[in] x

Tipo: INT

Intero che specifica la coordinata x dell'angolo superiore sinistro dell'immagine.

[in] y

Tipo: INT

Intero che specifica la coordinata y dell'angolo superiore sinistro dell'immagine.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Un oggetto CachedBitmap archivia un'immagine in un formato ottimizzato per una determinata schermata di visualizzazione. Non è possibile disegnare una bitmap memorizzata nella cache in una stampante o in un metafile.

Le bitmap memorizzate nella cache non funzionano con trasformazioni diverse dalla traduzione.

Quando si costruisce un oggetto CachedBitmap , è necessario passare l'indirizzo di un oggetto Graphics al costruttore. Se lo schermo associato all'oggetto Graphics ha una profondità bit modificata dopo la costruzione della bitmap memorizzata nella cache, il metodo Graphics::D rawCachedBitmap avrà esito negativo e sarà necessario ricostruire la bitmap memorizzata nella cache. In alternativa, è possibile associare il messaggio di notifica di modifica della visualizzazione e ricostruire la bitmap memorizzata nella cache in quel momento.

Esempio

Nell'esempio seguente viene chiamato Graphics::D rawCachedBitmap per disegnare l'immagine archiviata in un oggetto 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);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll