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


Метод IDWriteTextAnalyzer1::GetJustificationOpportunities (dwrite_1.h)

Извлекает сведения о возможных вариантах обоснования для каждого из глифов, заданных текстом и свойствами формирования глифа.

Синтаксис

HRESULT GetJustificationOpportunities(
        IDWriteFontFace                       *fontFace,
        FLOAT                                 fontEmSize,
        DWRITE_SCRIPT_ANALYSIS                scriptAnalysis,
        UINT32                                textLength,
        UINT32                                glyphCount,
  [in]  WCHAR const                           *textString,
  [in]  UINT16 const                          *clusterMap,
  [in]  DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
  [out] DWRITE_JUSTIFICATION_OPPORTUNITY      *justificationOpportunities
);

Параметры

fontFace

Тип: IDWriteFontFace*

Начертание шрифта, используемое для формирования. Это важно для возврата правильных результатов ширины кашиды.

Может иметь значение "NULL".

fontEmSize

Тип: FLOAT

Размер шрифта em, используемый для выполнения глифа.

scriptAnalysis

Тип: DWRITE_SCRIPT_ANALYSIS

Скрипт текста из элемента управления.

textLength

Тип: UINT32

Длина текста.

glyphCount

Тип: UINT32

Количество глифов.

[in] textString

Тип: const WCHAR*

Символы, используемые для создания глифов.

[in] clusterMap

Тип: const UINT16*

Карта кластера, созданная при формировании.

[in] glyphProperties

Тип: const DWRITE_SHAPING_GLYPH_PROPERTIES*

Свойства глифа, полученные при формировании.

[out] justificationOpportunities

Тип: DWRITE_JUSTIFICATION_OPPORTUNITY*

Указатель на структуру DWRITE_JUSTIFICATION_OPPORTUNITY , которая получает сведения о допустимом расширении и сжатии обоснования для каждого глифа.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Эта функция вызывается для каждого запуска после формирования с помощью метода IDWriteTextAnalyzer::GetGlyphs .

Обратите внимание, что эта функция поддерживает только естественные метрики (DWRITE_MEASURING_MODE_NATURAL).

 

Требования

   
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dwrite_1.h
Библиотека Dwrite_1.lib
DLL Dwrite_1.dll

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

IDWriteTextAnalyzer1