Поделиться через


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

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

Синтаксис

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Параметры

[in, optional] destPoint

Тип: const D2D1_POINT_2U*

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

[in] renderTarget

Тип: ID2D1RenderTarget*

Целевой объект отрисовки, содержащий копируемую область.

[in, optional] srcRect

Тип: const D2D1_RECT_U*

Область объекта renderTarget для копирования.

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

Тип: HRESULT

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

Комментарии

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

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

Все клипы и слои должны быть выброшены из целевого объекта отрисовки перед вызовом этого метода. Метод возвращает D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT , если к целевому объекту отрисовки применены какие-либо клипы или слои.

Требования

   
Минимальная версия клиента 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