Freigeben über


Graphics::D rawCachedBitmap-Methode (gdiplusgraphics.h)

Die Graphics::D rawCachedBitmap-Methode zeichnet das in einem CachedBitmap-Objekt gespeicherte Bild.

Syntax

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

Parameter

[in] cb

Typ: CachedBitmap*

Zeiger auf ein CachedBitmap-Objekt , das das zu zeichnende Bild enthält.

[in] x

Typ: INT

Eine ganze Zahl, die die x-Koordinate der oberen linken Ecke des Bilds angibt.

[in] y

Typ: INT

Eine ganze Zahl, die die y-Koordinate der oberen linken Ecke des Bilds angibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Ein CachedBitmap-Objekt speichert ein Bild in einem Format, das für einen bestimmten Anzeigebildschirm optimiert ist. Sie können keine zwischengespeicherte Bitmap auf einen Drucker oder eine Metadatei zeichnen.

Zwischengespeicherte Bitmaps funktionieren nicht mit anderen Transformationen als der Übersetzung.

Wenn Sie ein CachedBitmap-Objekt erstellen, müssen Sie die Adresse eines Graphics-Objekts an den Konstruktor übergeben. Wenn die Bittiefe des dem Graphics-Objekt zugeordneten Bildschirms geändert wurde, nachdem die zwischengespeicherte Bitmap erstellt wurde, schlägt die Graphics::D rawCachedBitmap-Methode fehl, und Sie sollten die zwischengespeicherte Bitmap rekonstruieren. Alternativ können Sie die Anzeigeänderungsbenachrichtigung einbinden und die zwischengespeicherte Bitmap zu diesem Zeitpunkt rekonstruieren.

Beispiele

Im folgenden Beispiel wird Graphics::D rawCachedBitmap aufgerufen, um das in einem CachedBitmap-Objekt gespeicherte Bild zu zeichnen.

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);
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Bitmap

Zeichnen, Positionieren und Klonen von Bildern

Grafiken

Verwenden einer zwischengespeicherten Bitmap zur Verbesserung der Leistung