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


Метод ID2D1PrintControl::AddPage (d2d1_1.h)

Преобразует примитивы Direct2D в списке переданных команд в фиксированное представление страницы для использования подсистемой печати.

Синтаксис

HRESULT AddPage(
  [in]            ID2D1CommandList *commandList,
                  D2D_SIZE_F       pageSize,
  [in, optional]  IStream          *pagePrintTicketStream,
  [out, optional] D2D1_TAG         *tag1,
  [out, optional] D2D1_TAG         *tag2
);

Параметры

[in] commandList

Тип: ID2D1CommandList*

Список команд, содержащий операции отрисовки.

pageSize

Тип: D2D_SIZE_F

Размер добавляемой страницы в DIP (1 дюйм == 96 DIP). Если драйвер печати не отвечает на этот параметр, можно использовать pagePrintTicketStream .

[in, optional] pagePrintTicketStream

Тип: IStream*

Поток билета на печать. Его можно использовать для изменения свойств текущей страницы; например, размер бумаги или ориентация.

[out, optional] tag1

Тип: D2D1_TAG*

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

[out, optional] tag2

Тип: D2D1_TAG*

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

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

Тип: HRESULT

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

HRESULT Описание:
S_OK Без ошибок.
E_OUTOFMEMORY Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG В возвращающую функцию передан недопустимый параметр.
D2DERR_PRINT_JOB_CLOSED Задание печати уже завершено.

Требования

Требование Значение
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1_1.h
Библиотека D2d1.lib

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

ID2D1PrintControl