Compartir a través de


Método ID2D1PrintControl::AddPage (d2d1_1.h)

Convierte primitivos de Direct2D en la lista de comandos pasados en una representación fija de página para su uso por parte del subsistema de impresión.

Sintaxis

HRESULT AddPage(
  [in]            ID2D1CommandList *commandList,
                  D2D_SIZE_F       pageSize,
  [in, optional]  IStream          *pagePrintTicketStream,
  [out, optional] D2D1_TAG         *tag1,
  [out, optional] D2D1_TAG         *tag2
);

Parámetros

[in] commandList

Tipo: ID2D1CommandList*

Lista de comandos que contiene las operaciones de representación.

pageSize

Tipo: D2D_SIZE_F

Tamaño de la página que se va a agregar, en DIP (1 pulgada == 96 DIP). Si el controlador de impresión no responde a este parámetro, puede usar pagePrintTicketStream en su lugar.

[in, optional] pagePrintTicketStream

Tipo: IStream*

Flujo de vale de impresión. Puede usarlo para modificar las propiedades de la página actual; por ejemplo, tamaño o orientación del papel.

[out, optional] tag1

Tipo: D2D1_TAG*

Contiene la primera etiqueta para las operaciones de dibujo posteriores. Este parámetro se pasa sin inicializar. Si se especifica NULL, no se recupera ningún valor para este parámetro.

[out, optional] tag2

Tipo: D2D1_TAG*

Contiene la segunda etiqueta para las operaciones de dibujo posteriores. Este parámetro se pasa sin inicializar. Si se especifica NULL, no se recupera ningún valor para este parámetro.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT Descripción
S_OK No se ha producido ningún error.
E_OUTOFMEMORY Direct2D no pudo asignar memoria suficiente para completar la llamada.
E_INVALIDARG Se pasó un parámetro no válido a la función de devolución.
D2DERR_PRINT_JOB_CLOSED El trabajo de impresión ya está terminado.

Requisitos

Requisito Value
Cliente mínimo compatible Actualización de windows 8 y plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1_1.h
Library D2d1.lib

Consulte también

ID2D1PrintControl