Freigeben über


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
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
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

Weitere Informationen

GetFontResource

IXpsOMFontResource

IXpsOMGlyphen

XML Paper Specification

XPS-Dokumentfehler