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 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1_1.h
Library	D2d1.lib

另请参阅

ID2D1PrintControl