Метод ITextRangeProvider::GetText (uiautomationcore.h)

  • Статья

Возвращает содержимое текстового диапазона в виде обычного текста.

Синтаксис

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

Параметры

[in] maxLength

Тип: int

Максимальная длина возвращаемой строки. Если длина не ограничена, задайте значение –1.

[out, retval] pRetVal

Тип: BSTR*

Получает обычный текст текстового диапазона, возможно, усеченный при заданной максимальной длине. Этот параметр передается неинициализированным.

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

Тип: HRESULT

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

Комментарии

ITextRangeProvider::GetText извлекает скрытый и видимый текст.

Если значение maxLength больше длины текстового диапазона вызывающего объекта, возвращаемая строка будет обычным текстом текстового диапазона.

ITextRangeProvider::GetText не будет зависеть от порядка конечных точек в текстовом потоке; он всегда будет возвращать текст между начальной и конечной точками текстового диапазона в порядке логического потока текста.

Требования

   
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)

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

Основные понятия

ITextProvider

ITextRangeProvider

Справочные материалы

Общие сведения о поставщиках автоматизации пользовательского интерфейса