IXpsOMPage1::Write1-Methode (xpsobjectmodel_1.h)

Artikel
03/13/2024

Schreibt die Seite in den angegebenen Stream.

Syntax

HRESULT Write1(
  ISequentialStream *stream,
  BOOL              optimizeMarkupSize,
  XPS_DOCUMENT_TYPE documentType
);

Parameter

stream

Der Stream, der den serialisierten Inhalt der Seite empfängt.

optimizeMarkupSize

Ein boolescher Wert, der angibt, ob das Dokumentmarkup der Seite für die Größe optimiert werden soll, wenn die Seite in den Stream geschrieben wird.

Wert	Bedeutung
true	Der Paketschreiber versucht, das Markup für die Mindestgröße zu optimieren, wenn die Seite in den Stream geschrieben wird.
false	Der Paketschreiber versucht beim Schreiben der Seite in den Stream keine Optimierung.

documentType

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	stream ist NULL.

Hinweise

Um das XPS-Markup einer Seite zu untersuchen, bevor sie in ein XPS-Paket geschrieben wird, kann eine Anwendung die Write-Methode aufrufen, um den Inhalt der Seite in einen Stream zu schreiben. Die Anwendung kann diesen Stream dann lesen, um das XPS-Markup zu untersuchen, da es serialisiert wird, wenn es in das XPS-Paket geschrieben wird.

Das XPS-Markup, das von dieser Methode in den Stream geschrieben wird, enthält das Seitenmarkup, aber keine der Ressourcen der Seite.