Freigeben über


IXpsOMGlyphsEditor::SetGlyphMappings-Methode (xpsobjectmodel.h)

Legt ein Array von XPS_GLYPH_MAPPING-Strukturen fest, die beschreiben, wie die UTF-16-Skalarwerte in der UnicodeString-Eigenschaft Einträgen im Array von XPS_GLYPH_INDEX Strukturen zugeordnet werden.

Syntax

HRESULT SetGlyphMappings(
  [in] UINT32                  glyphMappingCount,
  [in] const XPS_GLYPH_MAPPING *glyphMappings
);

Parameter

[in] glyphMappingCount

Die Anzahl der XPS_GLYPH_MAPPING Strukturen in dem Array, auf das von glyphMappings verwiesen wird. Der Wert 0 löscht die Eigenschaft.

[in] glyphMappings

Ein XPS_GLYPH_MAPPING-Strukturarray, das die Glyphenzuordnungswerte enthält. Wenn glyphMappingCount 0 ist, wird dieser Parameter ignoriert und kann auf NULL festgelegt werden.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, 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_INVALIDARG
Ein Element einer oder mehrerer XPS_GLYPH_MAPPING-Strukturen weist einen ungültigen Wert auf. Dies kann in folgenden Fällen auftreten: Die Summe der Zeichenfolgenlänge und der Startposition ist kleiner als die Startposition; die Summe aus Indexposition und Indexlänge ist kleiner als die Startposition; und die Länge der Indizes ist 0.
E_POINTER
glyphMappings ist NULL und glyphMappingCount ist größer als 0.
XPS_E_MAPPING_OUT_OF_ORDER
In einer oder mehreren XPS_GLYPH_MAPPING Strukturen ist ein Element nicht sequenziert.

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

IXpsOMGlyphenEditor

XML Paper Specification

XPS-Dokumentfehler

XPS_GLYPH_MAPPING