Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’interface IXpsOMPackageWriter crée un fichier de document XPS dans lequel les applications peuvent écrire le contenu des interfaces IXpsOMPage d’un om XPS. L’interface IXpsOMPackageWriter est la plus utile lorsque le contenu du document est traité ou créé séquentiellement. Contrairement aux méthodes WriteToFile et WriteToStream de l’interface IXpsOMPackage , pour que l’interface IXpsOMPackageWriter ne soit utilisée ni l’ensemble de FixedDocument ni le FixedDocumentSequence ne doit être terminé.
Aperçu
L’interface IXpsOMPackageWriter écrit une page à la fois, de la première page d’un document XPS au dernier. L’interface peut être utilisée pour créer des fichiers de documents XPS simples et des fichiers de documents XPS complexes qui contiennent plusieurs documents FixedDocument dans FixedDocumentSequence. Dans les fichiers de documents XPS complexes, les FixedDocuments sont également créés en séquence, en commençant par le premier FixedDocument dans FixedDocumentSequence. L’interface IXpsOMPackageWriter ne prend pas en charge la création du contenu du document dans un ordre aléatoire. Utilisez-le, par exemple, pour créer un rapport séquentiel ou effectuer un traitement dans un filtre de pilote de périphérique où le contenu du document est alimenté par le pilote en séquence.
Révision de la terminologie
Un fichier de document XPS est un package OPC (Open Packaging Conventions) conforme à la spécification de papier XML. Ainsi, techniquement, l’interface IXpsOMPackageWriter crée un package OPC, mais il s’agit d’un package OPC conforme à la spécification de papier XML. Pour cette raison, dans les discussions sur les documents XPS, les termes du document etdu package XPS sont souvent utilisés de manière interchangeable.
Le package créé par l’interface IXpsOMPackageWriter contient les composants de document XPS requis : un FixedDocumentSequence, au moins un FixedDocument et au moins un FixedPage. La FixedDocumentSequence est créée lorsque l’interface IXpsOMPackageWriter est instanciée. Un FixedDocument est créé chaque fois que IXpsOMPackageWriter ::StartNewDocument est appelé, et un FixedPage est créé chaque fois que IXpsOMPackageWriter ::AddPage est appelé. Étant donné que l’interface écrit le contenu du document de façon séquentielle, la méthode AddPage ajoute la page au document FixeDocument le plus récemment créé.
Utilisation de l’interface IXpsOMPackageWriter
La procédure suivante explique comment créer un fichier de document XPS à l’aide de l’interface IXpsOMPackageWriter . La procédure ne décrit pas comment instancier une interface IXpsOMPage et son contenu. Pour plus d’informations sur IXpsOMPage et l’ajout de contenu à une page, consultez interfaces de page OM XPS et les rubriques répertoriées dans la section Voir aussi.
Création d’un document
Instanciez une interface IXpsOMPackageWriter .
Cela crée un FixedDocumentSequence vide dans le package.
- Pour créer un document XPS dans un fichier, appelez IXpsOMObjectFactory ::CreatePackageWriterOnFile.
- Pour créer un document XPS dans un flux, appelez IXpsOMObjectFactory ::CreatePackageWriterOnStream.
Démarrez un nouveau document dans le package en appelant IXpsOMPackageWriter ::StartNewDocument.
Avant d’ajouter une page, appelez IXpsOMPackageWriter ::StartNewDocument pour ajouter un FixedDocument à l’objet FixedDocumentSequence créé à l’étape 1.
Ajoutez du contenu.
- Pour ajouter un nouveau FixedPage au document, appelez IXpsOMPackageWriter ::AddPage, en lui transmettant un pointeur vers l’interface IXpsOMPage qui contient le contenu de FixedPage que vous souhaitez ajouter.
- Pour créer un FixedDocument dans FixedDocumentSequence, appelez IXpsOMPackageWriter ::StartNewDocument.
Fermez le package et son contenu en appelant IXpsOMPackageWriter ::Close.
Fonctionnalités avancées
Les méthodes de l’interface IXpsOMPackageWriter prennent également en charge l’ajout de ressources, de miniatures et de tickets d’impression. Ces composants de document peuvent être ajoutés au niveau du package, de FixedDocumentSequence, de FixedDocument et de FixedPage. Pour plus d’informations sur l’utilisation de cette interface pour l’impression, consultez Imprimer un om XPS.
Rubriques connexes