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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

要件

こちらもご覧ください

ID2D1PrintControl