Метод Graphics::D rawCachedBitmap (gdiplusgraphics.h)

Статья
08/24/2023

Метод Graphics::D rawCachedBitmap рисует изображение, хранящееся в объекте CachedBitmap .

Синтаксис

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

Параметры

[in] cb

Тип: CachedBitmap*

Указатель на объект CachedBitmap , содержащий нарисованное изображение.

[in] x

Тип: INT

Целое число, указывающее координату X левого верхнего угла изображения.

[in] y

Тип: INT

Целое число, указывающее координату Y левого верхнего угла изображения.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Объект CachedBitmap хранит изображение в формате, оптимизированном для определенного экрана. Кэшированное растровое изображение нельзя нарисовать на принтере или в метафайл.

Кэшированные растровые изображения не будут работать с преобразованиями, кроме преобразования.

При создании объекта CachedBitmap необходимо передать в конструктор адрес объекта Graphics . Если после создания кэшированного растрового изображения на экране, связанном с этим объектом Graphics , битовая глубина изменена, метод Graphics::D rawCachedBitmap завершится сбоем, и необходимо восстановить кэшированное растровое изображение. Кроме того, можно подключить сообщение об изменении отображения и восстановить кэшированное растровое изображение.

Примеры

В следующем примере вызывается метод Graphics::D rawCachedBitmap для рисования изображения, хранящегося в объекте 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);
}

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusgraphics.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll

См. также раздел

Bitmap

Отрисовка, позиционирование и клонирование изображений

Графика

Использование кэшированного растрового изображения для повышения производительности