Condividi tramite


Metodo ID2D1PrintControl::AddPage (d2d1_1.h)

Converte le primitive Direct2D nell'elenco di comandi passato in una rappresentazione di pagina fissa da usare dal sottosistema di stampa.

Sintassi

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

Parametri

[in] commandList

Tipo: ID2D1CommandList*

Elenco di comandi contenente le operazioni di rendering.

pageSize

Tipo: D2D_SIZE_F

Dimensioni della pagina da aggiungere, in DIP (1 pollice == 96 DIP). Se il driver di stampa non risponde a questo parametro, è possibile usare invece pagePrintTicketStream .

[in, optional] pagePrintTicketStream

Tipo: IStream*

Flusso di ticket di stampa. È possibile usarlo per modificare le proprietà della pagina corrente; ad esempio, le dimensioni o l'orientamento della carta.

[out, optional] tag1

Tipo: D2D1_TAG*

Contiene la prima etichetta per le operazioni di disegno successive. Questo parametro viene passato non inizializzato. Se viene specificato NULL, non viene recuperato alcun valore per questo parametro.

[out, optional] tag2

Tipo: D2D1_TAG*

Contiene la seconda etichetta per le operazioni di disegno successive. Questo parametro viene passato non inizializzato. Se viene specificato NULL, non viene recuperato alcun valore per questo parametro.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

HRESULT Descrizione
S_OK Non si sono verificati errori.
E_OUTOFMEMORY Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG Un parametro non valido è stato passato alla funzione restituita.
D2DERR_PRINT_JOB_CLOSED Il processo di stampa è già stato completato.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 e Platform Update per Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione d2d1_1.h
Libreria D2d1.lib

Vedi anche

ID2D1PrintControl