Uso dell'interfaccia IXpsOMPackageWriter
L'interfacciaIXpsOMPackageWritercrea un file di documento XPS in cui le applicazioni possono scrivere il contenuto delle interfacceIXpsOMPagedi un OM XPS. L'interfacciaIXpsOMPackageWriterè più utile quando il contenuto del documento viene elaborato o creato in sequenza. A differenza dei metodi WriteToFile e WriteToStream dell'interfaccia IXpsOMPackage, per l'interfaccia IXpsOMPackageWriter non è necessario che siano completati né l'intero FixedDocument né il FixedDocumentSequence.
Panoramica
L'interfaccia IXpsOMPackageWriter scrive una pagina alla volta, dalla prima pagina di un documento XPS all'ultima. L'interfaccia può essere usata per creare semplici file di documento XPS e anche file di documento XPS complessi che contengono più di un FixedDocument in FixedDocumentSequence. Nei file di documenti XPS complessi, anche i FixedDocuments vengono creati in sequenza, a partire dal primo FixedDocument nella FixedDocumentSequence. L'interfaccia IXpsOMPackageWriter non supporta la creazione del contenuto del documento in ordine casuale. Utilizzalo, ad esempio, per creare un report sequenziale o per eseguire l'elaborazione in un filtro per il driver del dispositivo, dove il contenuto del documento viene inserito nel driver in sequenza.
Revisione della terminologia
Un file di documento XPS è un pacchetto OPC (Open Packaging Conventions) conforme alla specifica XML Paper. Tecnicamente, l'interfacciaIXpsOMPackageWritercrea un pacchetto OPC , ma è un pacchetto OPC conforme alla specifica XML Paper. Per questo motivo, nelle discussioni sui documenti XPS, i termini documento XPS e pacchetto vengono spesso usati in modo intercambiabile.
Il pacchetto creato dall'interfaccia IXpsOMPackageWriter conterrà i componenti necessari del documento XPS: un FixedDocumentSequence, almeno un FixedDocument e almeno una FixedPage. Viene creato il FixedDocumentSequence quando si istanzia l'interfaccia IXpsOMPackageWriter. Viene creato un oggetto FixedDocument ogni volta che viene chiamato IXpsOMPackageWriter::StartNewDocument e viene creato un oggetto FixedPage ogni volta che viene chiamato IXpsOMPackageWriter::AddPage. Poiché l'interfaccia scrive il contenuto del documento in sequenza, il metodo addPage aggiunge la pagina all'ultimo oggetto FixedDocument creato.
Uso dell'interfaccia IXpsOMPackageWriter
La procedura seguente descrive come creare un file di documento XPS usando l'interfacciaIXpsOMPackageWriter. La procedura non descrive come creare un'istanza dell'interfaccia IXpsOMPage e i suoi contenuti. Per altre informazioni su IXpsOMPage e sull'aggiunta di contenuto a una pagina, vedere XPS OM Page Interfaces e gli argomenti elencati nella sezione Vedere anche.
Creazione di un documento
Creare un'istanza di dell'interfaccia IXpsOMPackageWriter.
In questo modo viene creata una sequenza FixedDocumentSequence vuota nel pacchetto.
- Per creare un documento XPS in un file, chiamare IXpsOMObjectFactory::CreatePackageWriterOnFile.
- Per creare un documento XPS in un flusso, chiamare IXpsOMObjectFactory::CreatePackageWriterOnStream.
Avviare un nuovo documento nel pacchetto chiamando IXpsOMPackageWriter::StartNewDocument.
Prima di aggiungere una pagina, chiamare IXpsOMPackageWriter::StartNewDocument per aggiungere fixedDocument all'oggetto FixedDocumentSequence creato nel passaggio 1.
Aggiungere contenuto.
- Per aggiungere un nuovo FixedPage al documento, chiamare IXpsOMPackageWriter::AddPage, passando un puntatore all'interfaccia IXpsOMPage che contiene i contenuti di FixedPage che si desidera aggiungere.
- Per creare un nuovo FixedDocument in FixedDocumentSequence, chiamare IXpsOMPackageWriter::StartNewDocument.
Chiudere il pacchetto e il relativo contenuto chiamando IXpsOMPackageWriter::Close.
Funzionalità avanzate
I metodi dell'interfaccia IXpsOMPackageWriter supportano anche l'aggiunta di risorse, anteprime e ticket di stampa. Questi componenti del documento possono essere aggiunti ai livelli Package, FixedDocumentSequence, FixedDocument e FixedPage. Per altre informazioni sull'uso di questa interfaccia per la stampa, vedere Stampare un file XPS OM.
Argomenti correlati