Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De IXpsOMPackageWriter interface maakt een XPS-documentbestand waarin toepassingen de inhoud van de IXpsOMPage interfaces van een XPS OM kunnen schrijven. De interface IXpsOMPackageWriter is het handigst wanneer documentinhoud opeenvolgend wordt verwerkt of gemaakt. In tegenstelling tot de WriteToFile en WriteToStream methoden van de IXpsOMPackage interface, hoeft voor de IXpsOMPackageWriter interface noch het volledige FixedDocument noch de FixedDocumentSequence te worden voltooid.
Overzicht
De IXpsOMPackageWriter interface schrijft één pagina tegelijk, van de eerste pagina van een XPS-document naar het laatst. De interface kan worden gebruikt voor het maken van eenvoudige XPS-documentbestanden en ook complexe XPS-documentbestanden die meer dan één FixedDocument in de FixedDocumentSequence bevatten. In complexe XPS-documentbestanden worden de FixedDocuments ook op volgorde gemaakt, te beginnen met het eerste FixedDocument in de FixedDocumentSequence. De interface IXpsOMPackageWriter biedt geen ondersteuning voor het maken van documentinhoud in willekeurige volgorde. Gebruik het bijvoorbeeld om een sequentiële rapport te maken of om verwerking uit te voeren in een apparaatstuurprogrammafilter waarbij de inhoud van het document op volgorde aan het stuurprogramma wordt doorgegeven.
Terminologiebeoordeling
Een XPS-documentbestand is een OPC-pakket (Open Packaging Conventions) dat voldoet aan de XML Paper Specification. Technisch gezien maakt de IXpsOMPackageWriter interface een OPC-pakket, maar het is een OPC-pakket dat voldoet aan de XML-papierspecificatie. Daarom worden in discussies over XPS-documenten de termen XPS-document en pakket vaak door elkaar gebruikt.
Het -pakket gemaakt door de interface IXpsOMPackageWriter bevat de vereiste XPS-documentonderdelen: een FixedDocumentSequence, ten minste één FixedDocument en ten minste één FixedPage. De FixedDocumentSequence wordt gemaakt wanneer de interface IXpsOMPackageWriter wordt geïnstantieerd. Er wordt telkens een FixedDocument gemaakt wanneer IXpsOMPackageWriter::StartNewDocument wordt aangeroepen en er wordt elke keer een FixedPage gemaakt wanneer IXpsOMPackageWriter::AddPage wordt aangeroepen. Omdat de interface de documentinhoud opeenvolgend schrijft, voegt de methode AddPage de pagina toe aan het laatst gemaakte FixedDocument.
De interface IXpsOMPackageWriter gebruiken
In de volgende procedure wordt beschreven hoe u een XPS-documentbestand maakt met behulp van de interface IXpsOMPackageWriter. In de procedure wordt niet beschreven hoe u een IXpsOMPage interface en de inhoud ervan kunt instantiëren. Zie XPS OM-paginainterfaces en de onderwerpen in de sectie Zie Ook voor meer informatie over IXpsOMPage en het toevoegen van inhoud aan een pagina.
Een document maken
Instantieer een IXpsOMPackageWriter interface.
Hiermee maakt u een lege FixedDocumentSequence in het pakket.
- Als u een XPS-document in een bestand wilt maken, roept u IXpsOMObjectFactory::CreatePackageWriterOnFileaan.
- Als u een XPS-document in een stream wilt maken, roept u IXpsOMObjectFactory::CreatePackageWriterOnStreamaan.
Start een nieuw document in het pakket door IXpsOMPackageWriter::StartNewDocumentaan te roepen.
Voordat u een pagina toevoegt, roept u IXpsOMPackageWriter::StartNewDocument aan om een FixedDocument toe te voegen aan de FixedDocumentSequence die in stap 1 is gemaakt.
Inhoud toevoegen.
- Als u een nieuwe FixedPage aan het document wilt toevoegen, roept u IXpsOMPackageWriter::AddPageaan en geeft u er een aanwijzer naar de IXpsOMPage interface mee, die de inhoud bevat van de FixedPage die u wilt toevoegen.
- Als u een nieuwe FixedDocument wilt maken in de FixedDocumentSequence, roept u IXpsOMPackageWriter::StartNewDocument.
Sluit het pakket en de inhoud door IXpsOMPackageWriter::Closeaan te roepen.
Geavanceerde functies
De methoden van de IXpsOMPackageWriter interface ondersteunen ook het toevoegen van resources, miniaturen en printtickets. Deze documentonderdelen kunnen worden toegevoegd op de niveaus Package, FixedDocumentSequence, FixedDocument en FixedPage. Zie Een XPS OM-afdrukken voor meer informatie over het gebruik van deze interface voor afdrukken.
Verwante onderwerpen