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*
後続の描画操作の 2 番目のラベルが含まれます。 このパラメーターは初期化せずに渡されます。 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 |
| ヘッダー | d2d1_1.h |
| Library | D2d1.lib |