Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Gränssnittet IXpsOMPackageWriter skapar en XPS-dokumentfil där program kan skriva innehållet i IXpsOMPage- gränssnitt i en XPS OM. Gränssnittet IXpsOMPackageWriter är mest användbart när dokumentinnehåll bearbetas eller skapas sekventiellt. Till skillnad från metoderna WriteToFile och WriteToStream i IXpsOMPackage--gränssnittet behöver varken hela FixedDocument eller FixedDocumentSequence vara färdigställda för att kunna använda IXpsOMPackageWriter--gränssnittet.
Överblick
Gränssnittet IXpsOMPackageWriter skriver en sida i taget, från den första sidan i ett XPS-dokument till det sista. Gränssnittet kan användas för att skapa enkla XPS-dokumentfiler och även komplexa XPS-dokumentfiler som innehåller mer än ett FixedDocument i FixedDocumentSequence. I komplexa XPS-dokumentfiler skapas även FixedDocuments i följd, från och med det första FixedDocument i FixedDocumentSequence. Gränssnittet IXpsOMPackageWriter stöder inte skapandet av dokumentinnehåll i slumpmässig ordning. Använd den till exempel för att skapa en sekventiell rapport eller för att utföra bearbetning i ett enhetsdrivrutinsfilter där dokumentinnehållet matas till drivrutinen i följd.
Terminologigranskning
En XPS-dokumentfil är ett OPC-paket (Open Packaging Conventions) som överensstämmer med XML-pappersspecifikationen. Tekniskt sett skapar IXpsOMPackageWriter--gränssnittet därför ett OPC-paket, men det är ett OPC-paket som överensstämmer med XML-pappersspecifikationen. I diskussioner om XPS-dokument används därför termerna XPS-dokument och paket ofta omväxlande.
Det paket som som skapats av IXpsOMPackageWriter--gränssnittet innehåller nödvändiga XPS-dokumentkomponenter: en FixedDocumentSequence, minst en FixedDocument och minst en FixedPage. FixedDocumentSequence skapas när gränssnittet IXpsOMPackageWriter instansieras. En FixedDocument skapas varje gång IXpsOMPackageWriter::StartNewDocument anropas och en FixedPage skapas varje gång IXpsOMPackageWriter::AddPage anropas. Eftersom gränssnittet skriver dokumentinnehållet sekventiellt lägger metoden AddPage till sidan i den senast skapade FixedDocument.
Använda IXpsOMPackageWriter-gränssnittet
Följande procedur beskriver hur du skapar en XPS-dokumentfil med hjälp av gränssnittet IXpsOMPackageWriter. Proceduren beskriver inte hur du instansierar ett IXpsOMPage--gränssnitt och dess innehåll. Mer information om IXpsOMPage och hur du lägger till innehåll på en sida finns i XPS OM-sidgränssnitt och de avsnitt som visas i avsnittet Se även.
Skapa ett dokument
Instansiera ett IXpsOMPackageWriter--gränssnitt.
Detta skapar en tom FixedDocumentSequence i paketet.
- Om du vill skapa ett XPS-dokument i en fil anropar du IXpsOMObjectFactory::CreatePackageWriterOnFile.
- Om du vill skapa ett XPS-dokument i en ström anropar du IXpsOMObjectFactory::CreatePackageWriterOnStream.
Starta ett nytt dokument i paketet genom att anropa IXpsOMPackageWriter::StartNewDocument.
Innan du lägger till en sida anropar du IXpsOMPackageWriter::StartNewDocument för att lägga till en FixedDocument i FixedDocumentSequence som skapades i steg 1.
Lägg till innehåll.
- Om du vill lägga till en ny FixedPage i dokumentet anropar du IXpsOMPackageWriter::AddPageoch skickar den en pekare till IXpsOMPage- gränssnitt som innehåller innehållet i den FixedPage som du vill lägga till.
- Om du vill skapa en ny FixedDocument i FixedDocumentSequence anropar du IXpsOMPackageWriter::StartNewDocument.
Stäng paketet och dess innehåll genom att anropa IXpsOMPackageWriter::Stäng.
Avancerade funktioner
Metoderna för IXpsOMPackageWriter-gränssnittet stöder också tillägg av resurser, miniatyrbilder och utskriftsbiljetter. Dessa dokumentkomponenter kan läggas till i paketnivåerna FixedDocumentSequence, FixedDocument och FixedPage. Mer information om hur du använder det här gränssnittet för utskrift finns i Skriv ut en XPS OM-.
Relaterade ämnen