Метод 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 |