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

Статья
05/30/2024

Преобразует примитивы 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

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