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

Метод 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

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

IDWriteTextAnalysisSource