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

Converte primitivos Direct2D na lista de comandos passados em uma representação de página fixa para uso pelo subsistema de impressão.

Sintaxe

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*

A lista de comandos que contém as operações de renderização.

pageSize

Tipo: D2D_SIZE_F

O tamanho da página a ser adicionada, em DIPs (1 polegada == 96 DIP). Se o driver de impressão não responder a esse parâmetro, você poderá usar pagePrintTicketStream .

[in, optional] pagePrintTicketStream

Tipo: IStream*

O fluxo de tíquete de impressão. Você pode usar isso para modificar as propriedades da página atual; por exemplo, tamanho ou orientação do papel.

[out, optional] tag1

Tipo: D2D1_TAG*

Contém o primeiro rótulo para operações de desenho subsequentes. Este parâmetro é passado não inicializado. Se NULL for especificado, nenhum valor será recuperado para esse parâmetro.

[out, optional] tag2

Tipo: D2D1_TAG*

Contém o segundo rótulo para operações de desenho subsequentes. Este parâmetro é passado não inicializado. Se NULL for especificado, nenhum valor será recuperado para esse parâmetro.

Retornar valor

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT Descrição
S_OK Não ocorreu nenhum erro.
E_OUTOFMEMORY O Direct2D não pôde alocar memória suficiente para concluir a chamada.
E_INVALIDARG Um parâmetro inválido foi passado para a função de retorno.
D2DERR_PRINT_JOB_CLOSED O trabalho de impressão já foi concluído.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
Biblioteca D2d1.lib

Confira também

ID2D1PrintControl