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

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

  • Статья

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

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

Синтаксис

HRESULT SetFontFaceIndex(
  [in] SHORT fontFaceIndex
);

Параметры

[in] fontFaceIndex

Значение индекса используемой грани шрифта.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 Недопустимое значение fontFaceIndex ; это должно быть целое число, которое больше или равно –1.

Комментарии

Значение по умолчанию для свойства индекса лица шрифта равно –1, что означает, что индекс шрифта не задан или ресурс шрифта не является коллекцией шрифтов TrueType .

Если это значение указано и не равно –1, во время сериализации к URI шрифта добавляется #<Index>. Здесь Индекс> — это значение, <заданное SetFontFaceIndex.

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

    <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

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

IXpsOMGlyphs

XPS

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