Metodo IXpsOMObjectFactory::CreatePackageWriterOnStream (xpsobjectmodel.h)

Articolo
03/09/2024

Apre un flusso per scrivere il contenuto di un file XPS OM in un pacchetto XPS.

Sintassi

HRESULT CreatePackageWriterOnStream(
  [in]          ISequentialStream         *outputStream,
  [in]          BOOL                      optimizeMarkupSize,
  [in]          XPS_INTERLEAVING          interleaving,
  [in]          IOpcPartUri               *documentSequencePartName,
  [in]          IXpsOMCoreProperties      *coreProperties,
  [in]          IXpsOMImageResource       *packageThumbnail,
  [in]          IXpsOMPrintTicketResource *documentSequencePrintTicket,
  [in]          IOpcPartUri               *discardControlPartName,
  [out, retval] IXpsOMPackageWriter       **packageWriter
);

Parametri

[in] outputStream

Flusso da utilizzare per la scrittura.

[in] optimizeMarkupSize

Valore booleano che indica se il markup del documento verrà ottimizzato per le dimensioni quando il documento viene scritto nel flusso.

Valore	Significato
VERO	Durante la scrittura nel flusso, il writer di pacchetti tenterà di ottimizzare il markup per le dimensioni minime.
FALSE	Durante la scrittura nel pacchetto, il writer del pacchetto non tenterà alcuna ottimizzazione.

[in] interleaving

Specifica se il contenuto di XPS OM verrà interleavedato quando viene scritto nel flusso.

[in] documentSequencePartName

Interfaccia IOpcPartUri che contiene il nome della parte della sequenza di documento nel nuovo file.

[in] coreProperties

Interfaccia IXpsOMCoreProperties che contiene le proprietà principali del documento da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

[in] packageThumbnail

Interfaccia IXpsOMImageResource che contiene l'immagine di anteprima da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

[in] documentSequencePrintTicket

Interfaccia IXpsOMPrintTicketResource che contiene il ticket di stampa a livello di pacchetto da assegnare al nuovo file. Questo parametro può essere impostato su NULL.

[in] discardControlPartName

Interfaccia IOpcPartUri che contiene il nome della parte del controllo discard. Questo parametro può essere impostato su NULL.

[out, retval] packageWriter

Puntatore alla nuova interfaccia IXpsOMPackageWriter creata da questo metodo.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	outputStream, documentSequencePartName o packageWriter è NULL.
XPS_E_NO_CUSTOM_OBJECTS	coreProperties, documentSequencePrintTicket o packageThumbnail non punta a un'implementazione dell'interfaccia riconosciuta. L'implementazione personalizzata delle interfacce API documento XPS non è supportata.

Questo metodo chiama l'API di creazione pacchetti . Per informazioni sui valori restituiti dell'API per la creazione di pacchetti, vedere Errori di creazione di pacchetti.

Commenti

Il flusso viene aperto e inizializzato e quindi l'interfaccia IXpsOMPackageWriter restituita viene usata per scrivere tipi di contenuto, relazioni tra pacchetti, proprietà principali, risorse della sequenza di documenti e relazioni tra sequenze di documenti.

Se documentSequencePrintTicket è impostato su NULL e il valore di interleaving è XPS_INTERLEAVING_ON, questo metodo crea un ticket di stampa vuoto a livello di processo e aggiunge una relazione al ticket di stampa vuoto. Questa operazione viene eseguita per offrire un consumo di streaming più efficiente del pacchetto.

Se documentSequencePrintTicket è impostato su NULL e il valore di interleaving è XPS_INTERLEAVING_OFF, non viene creato alcun ticket di stampa vuoto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h