ID2D1PrintControl ::AddPage, méthode (d2d1_1.h)

Article
05/30/2024

Convertit les primitives Direct2D de la liste de commandes passées en une représentation de page fixe à utiliser par le sous-système d’impression.

Syntaxe

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

Paramètres

[in] commandList

Type : ID2D1CommandList*

Liste de commandes qui contient les opérations de rendu.

pageSize

Type : D2D_SIZE_F

Taille de la page à ajouter, en DIP (1 pouce == 96 DIP). Si le pilote d’impression ne répond pas à ce paramètre, vous pouvez utiliser pagePrintTicketStream à la place.

[in, optional] pagePrintTicketStream

Type : IStream*

Flux de ticket d’impression. Vous pouvez l’utiliser pour modifier les propriétés de la page active . par exemple, le format ou l’orientation du papier.

[out, optional] tag1

Type : D2D1_TAG*

Contient la première étiquette pour les opérations de dessin suivantes. Ce paramètre est passé sans être initialisé. Si NULL est spécifié, aucune valeur n’est récupérée pour ce paramètre.

[out, optional] tag2

Type : D2D1_TAG*

Contient la deuxième étiquette pour les opérations de dessin suivantes. Ce paramètre est passé sans être initialisé. Si NULL est spécifié, aucune valeur n’est récupérée pour ce paramètre.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT	Description
S_OK	Aucune erreur ne s'est produite.
E_OUTOFMEMORY	Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG	Un paramètre non valide a été passé à la fonction de retour.
D2DERR_PRINT_JOB_CLOSED	Le travail d’impression est déjà terminé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	d2d1_1.h
Bibliothèque	D2d1.lib

Voir aussi

ID2D1PrintControl

Partager via