Метод ID2D1Bitmap::CopyFromBitmap (d2d1.h)

  • Статья

Копирует указанную область из указанного растрового изображения в текущее растровое изображение.

Синтаксис

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Параметры

[in, optional] destPoint

Тип: const D2D1_POINT_2U*

На текущем растровом рисунке верхний левый угол области, в которую копируется область, указанная srcRect .

[in] bitmap

Тип: ID2D1Bitmap*

Точечный рисунок для копирования.

[in, optional] srcRect

Тип: const D2D1_RECT_U*

Область точечных рисунков для копирования.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не обновляет размер текущего растрового изображения. Если содержимое исходного растрового рисунка не помещается в текущее растровое изображение, этот метод завершается ошибкой. Кроме того, обратите внимание, что этот метод не выполняет преобразование формата и завершится ошибкой, если форматы растровых рисунков не совпадают.

Вызов этого метода может привести к очистке текущего пакета, если растровое изображение активно в пакете. Если пакет, который был удален, не завершается успешно, этот метод завершается сбоем. Однако этот метод не очищает состояние ошибки целевого объекта отрисовки, в котором был снят пакет. Состояние сбоя HRESULT и тега будут возвращены при следующем вызове EndDraw или Flush.

Начиная с Windows 8.1 этот метод поддерживает блочные сжатые растровые изображения. При использовании формата со сжатым блоком конечные координаты параметра srcRect должны быть кратны 4, иначе метод возвращает E_INVALIDARG.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

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

ID2D1Bitmap