Метод IDWriteTextAnalysisSource::GetTextAtPosition (dwrite.h)
Возвращает блок текста, начинающийся с указанной позиции текста.
Синтаксис
HRESULT GetTextAtPosition(
UINT32 textPosition,
[out] WCHAR const **textString,
[out] UINT32 *textLength
);
Параметры
textPosition
Тип: UINT32
Первая позиция получаемого фрагмента. Все позиции находятся в единицах кода UTF16 , а не целых символах, что имеет значение при использовании дополнительных символов.
[out] textString
Тип: const WCHAR**
При возврате этим методом содержит адрес блока текста в виде массива символов, извлекаемых из анализа текста.
[out] textLength
Тип: UINT32*
При возврате этим методом содержит количество единиц UTF16 полученного блока. Возвращаемая длина не является длиной блока, а длиной, оставшейся в блоке, от указанной позиции до его конца. Например, запрос позиции, которая составляет 75 позиций в блоке из 100 позиций, вернет 25.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Возвращая значение NULL , указывает конец текста, который является позицией после последнего символа. Эта функция называется итеративно для каждого последовательного блока, связав несколько фрагментированных блоков в резервном хранилище в виртуальную непрерывную строку.
Хотя приложения могут реализовывать разреженное текстовое содержимое, которое сопоставляет только часть резервного хранилища, приложение должно сопоставлять любой текст, который находится в диапазоне, переданном любым функциям анализа.
Требования
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | dwrite.h |
| Библиотека | Dwrite.lib |
| DLL | Dwrite.dll |