Метод IDWriteTextAnalyzer1::GetTextComplexity (dwrite_1.h)
Определяет сложность текста и необходимость вызова IDWriteTextAnalyzer::GetGlyphs для полного формирования скрипта.
Синтаксис
HRESULT GetTextComplexity(
[in] WCHAR const *textString,
UINT32 textLength,
IDWriteFontFace *fontFace,
[out] BOOL *isTextSimple,
[out] UINT32 *textLengthRead,
[out, optional] UINT16 *glyphIndices
);
Параметры
[in] textString
Тип: const WCHAR*
Текст, проверка для сложности. Эта строка может быть UTF-16, но любые дополнительные символы будут считаться сложными.
textLength
Тип: UINT32
Длина текста до проверка.
fontFace
Тип: IDWriteFontFace*
Лицо шрифта для чтения.
[out] isTextSimple
Тип: BOOL*
Если значение равно true, текст будет простым, а массив glyphIndices уже будет иметь номинальные глифы. В противном случае необходимо вызвать IDWriteTextAnalyzer::GetGlyphs , чтобы правильно формировать сложные скрипты и функции OpenType.
[out] textLengthRead
Тип: UINT32*
Длина чтения текста выполняется с той же сложностью, простой или сложной. С этого момента вы можете позвонить еще раз.
[out, optional] glyphIndices
Тип: UINT16*
Необязательные индексы глифов для текста. Если функция вернула, что текст прост, у вас уже есть необходимые глифы. В противном случае индексы глифов не имеют смысла, и вместо этого необходимо вызвать IDWriteTextAnalyzer::GetGlyphs для формирования.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Текст не прост, если символы являются частью скрипта, который имеет сложные требования к формированию, требует анализа биди, объединения с другими символами, находятся в дополнительных плоскостях или имеют глифы, которые участвуют в стандартных функциях OpenType. Возвращаемая длина не будет разделять объединяющие знаки из их базовых символов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | dwrite_1.h |
| Библиотека | Dwrite.lib |
| DLL | Dwrite.dll |