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 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
程式庫 D2d1.lib

另請參閱

ID2D1PrintControl