Freigeben über


IXpsOMFontResource::SetContent-Methode (xpsobjectmodel.h)

Legt den schreibgeschützten Stream fest, der dieser Ressource zugeordnet werden soll.

Syntax

HRESULT SetContent(
  [in] IStream            *sourceStream,
  [in] XPS_FONT_EMBEDDING embeddingOption,
  [in] IOpcPartUri        *partName
);

Parameter

[in] sourceStream

Der schreibgeschützte Stream, der dieser Ressource zugeordnet werden soll.

[in] embeddingOption

Der XPS_FONT_EMBEDDING Wert, der beschreibt, wie die Ressource verschleiert werden soll.

Wert Bedeutung
XPS_FONT_EMBEDDING_NORMAL
Die Schriftartressource ist weder verschleiert noch eingeschränkt.
XPS_FONT_EMBEDDING_OBFUSCATED
Die Schriftartressource ist verschleiert, aber nicht eingeschränkt.
XPS_FONT_EMBEDDING_RESTRICTED
Die Schriftartressource ist sowohl verschleiert als auch eingeschränkt.

[in] partName

Der Teilename, der dieser Ressource zugewiesen werden soll.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Die aufrufende Methode sollte diesen Stream als STA-Modellobjekt (Single-Threaded Apartment) behandeln und keine der Methoden der Streamschnittstelle erneut eingeben.

Der dieser Ressource zugewiesene Stream sollte nicht verschleiert werden. Die Verschleierung der Schriftartressource erfolgt während der Serialisierung.

Das Bereitstellen eines verschleierten Schriftartstreams beim Festlegen von embeddingOption auf XPS_FONT_EMBEDDING_OBFUSCATED führt zu einer Schriftart, die im serialisierten XPS-Dokument nicht verschleiert wird.

partName setzt den Teilenamen für dieses Objekt zurück und wird anhand des Werts von embeddingOption auf die richtige Verschleierungssyntax überprüft.

Da GetStream einen Klon des Datenstroms abruft, der von dieser Methode festgelegt wird, sollte der bereitgestellte Stream über eine effiziente Klonmethode verfügen. Ein Stream mit einer ineffizienten Klonmethode verringert die Leistung von GetStream.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile xpsobjectmodel.h

Weitere Informationen

IOpcPartUri

IXpsOMFontResource

XML Paper Specification

XPS_FONT_EMBEDDING