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 |