Поделиться через


Метод IXpsOMGlyphs::GetFontFaceIndex (xpsobjectmodel.h)

Возвращает индекс используемого шрифта.

Это значение используется, только если GetFontResource возвращает интерфейс IXpsOMFontResource , представляющий коллекцию шрифтов TrueType .

Синтаксис

HRESULT GetFontFaceIndex(
  [out, retval] SHORT *fontFaceIndex
);

Параметры

[out, retval] fontFaceIndex

Значение индекса лица шрифта. Если начертание шрифта не задано, возвращается значение –1.

Возвращаемое значение

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в разделе Ошибки документа XPS.

Код возврата Описание
S_OK
Метод выполнен успешно.
E_POINTER
fontFaceIndex имеет значение NULL.

Комментарии

Ресурс шрифта получается путем вызова метода GetFontResource .

Если шрифт не задан или не поддерживается шрифтом, в fontFaceIndex возвращается значение –1. При загрузке глифа из существующего файла документа XPS значение fontFaceIndex –1 указывает, что атрибут FontUri не содержит фрагмент #index .

В следующей разметке Объекта FixedPage атрибут FontUri элемента Glyphs имеет значение ../Resources/Fonts/Font.TTF#1. В этом случае GetFontFaceIndex вернет значение 1 в fontFaceIndex.

    <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>

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header xpsobjectmodel.h

См. также раздел

GetFontResource

IXpsOMFontResource

IXpsOMGlyphs

XPS

Ошибки документа XPS