IXpsOMGlyphen::SetFontFaceIndex-Methode (xpsobjectmodel.h)
Legt den Index des zu verwendenden Schriftzeichens fest.
Dieser Wert wird nur verwendet, wenn GetFontResource eine IXpsOMFontResource-Schnittstelle zurückgibt, die eine TrueType-Schriftartsammlung darstellt.
Syntax
HRESULT SetFontFaceIndex(
[in] SHORT fontFaceIndex
);
Parameter
[in] fontFaceIndex
Der Indexwert der zu verwendenden Schriftart.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der Wert von fontFaceIndex ist ungültig. Es muss sich um eine ganze Zahl handeln, die größer oder gleich –1 ist. |
Hinweise
Der Standardwert der Schriftartsichtindexeigenschaft ist –1. Dies bedeutet, dass kein Schriftartindex festgelegt wurde oder dass die Schriftartressource keine TrueType-Schriftartsammlung ist.
Wenn dieser Wert angegeben ist und nicht –1 ist, wird "#<Index>" während der Serialisierung an den Schriftart-URI angefügt. Hier ist Index> der Wert, <der von SetFontFaceIndex festgelegt wird.
Das folgende Markup einer FixedPage zeigt das Ergebnis des Festlegens des fontFaceIndex auf 1. Beachten Sie, dass das FontUri-Attribut des Glyphen-Elements den Wert hat, der ../Resources/Fonts/Font.TTF#1den Index der Schriftartseite enthält.
<FixedPage Height="1056" Width="816" xml:lang="en-US"
xmlns="http://schemas.microsoft.com/xps/2005/06">
<Glyphs
OriginX="96"
OriginY="96"
UnicodeString="This is Page 1!"
FontUri="../Resources/Fonts/Font.TTF#1"
FontRenderingEmSize="16" />
</FixedPage>
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 |