IXpsOMGlyphs::GetFontFaceIndex-Methode (xpsobjectmodel.h)
Ruft den Index der zu verwendenden Schriftart ab.
Dieser Wert wird nur verwendet, wenn GetFontResource eine IXpsOMFontResource-Schnittstelle zurückgibt, die eine TrueType-Schriftartensammlung darstellt.
Syntax
HRESULT GetFontFaceIndex(
[out, retval] SHORT *fontFaceIndex
);
Parameter
[out, retval] fontFaceIndex
Der Indexwert der Schriftart. Wenn die Schriftart nicht festgelegt wurde, wird –1 zurückgegeben.
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 |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
fontFaceIndex ist NULL. |
Hinweise
Die Schriftartressource wird durch Aufrufen der GetFontResource-Methode abgerufen.
Wenn eine Schriftart nicht festgelegt wurde oder von der Schriftart nicht unterstützt wird, wird der Wert –1 in fontFaceIndex zurückgegeben. Wenn die Glyphe aus einer vorhandenen XPS-Dokumentdatei geladen wird, gibt der fontFaceIndex-Wert –1 an, dass das FontUri-Attribut kein #index Fragment enthält.
Im folgenden Markup eines FixedPage-Elements weist das FontUri-Attribut des Glyphs-Elements den Wert auf ../Resources/Fonts/Font.TTF#1
. In diesem Fall würde GetFontFaceIndex den Wert 1 in fontFaceIndex zurückgeben.
<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 |