Интерфейс IUIAutomationTextRange (uiautomationclient.h)

Предоставляет доступ к диапазону непрерывного текста в контейнере, поддерживающем интерфейс IUIAutomationTextPattern . Клиентские приложения могут использовать интерфейс IUIAutomationTextRange для выбора, сравнения и извлечения внедренных объектов из текстового диапазона. Интерфейс использует две конечные точки для разделения места начала и окончания текстового диапазона. Несвязанные диапазоны текста представлены интерфейсом IUIAutomationTextRangeArray .

Наследование

Интерфейс IUIAutomationTextRange наследуется от интерфейса IUnknown . IUIAutomationTextRange также имеет следующие типы элементов:

Методы

Интерфейс IUIAutomationTextRange содержит следующие методы.

IUIAutomationTextRange::AddToSelection Добавляет диапазон текста в коллекцию выделенных текстовых диапазонов в элементе управления , который поддерживает несколько несвязанных диапазонов выделенного текста. (IUIAutomationTextRange.AddToSelection)
IUIAutomationTextRange::Clone Извлекает новый объект IUIAutomationTextRange, идентичный исходному объекту, и наследует все свойства исходного объекта.
IUIAutomationTextRange::Compare Извлекает значение, указывающее, имеет ли этот текстовый диапазон те же конечные точки, что и другой текстовый диапазон. (IUIAutomationTextRange.Compare)
IUIAutomationTextRange::CompareEndpoints Извлекает значение, указывающее, является ли начальная или конечная точка этого текстового диапазона такой же, как начальная или конечная точка другого текстового диапазона.
IUIAutomationTextRange::ExpandToEnclosingUnit Нормализует диапазон текста по заданной единице текста. Диапазон расширяется, если он меньше указанной единицы, или сокращается, если он длиннее указанной единицы. (IUIAutomationTextRange.ExpandToEnclosingUnit)
IUIAutomationTextRange::FindAttribute Извлекает подмножество текстового диапазона, которое имеет указанное значение атрибута текста.
IUIAutomationTextRange::FindText Извлекает подмножество текстового диапазона, содержащее указанный текст.
IUIAutomationTextRange::GetAttributeValue Извлекает значение указанного атрибута текста во всем текстовом диапазоне.
IUIAutomationTextRange::GetBoundingRectangles Возвращает коллекцию ограничивающих прямоугольников для каждой полностью или частично видимой строки текста в текстовом диапазоне. (IUIAutomationTextRange.GetBoundingRectangles)
IUIAutomationTextRange::GetChildren Возвращает коллекцию всех внедренных объектов, попадающих в текстовый диапазон. (IUIAutomationTextRange.GetChildren)
IUIAutomationTextRange::GetEnclosingElement Возвращает самый внутренний элемент автоматизации пользовательского интерфейса, который заключает текстовый диапазон.
IUIAutomationTextRange::GetText Возвращает содержимое текстового диапазона в виде обычного текста.
IUIAutomationTextRange::Move Перемещает текстовый диапазон вперед или назад на указанное количество единиц текста.
IUIAutomationTextRange::MoveEndpointByRange Перемещает одну конечную точку текущего текстового диапазона в указанную конечную точку второго текстового диапазона. (IUIAutomationTextRange.MoveEndpointByRange)
IUIAutomationTextRange::MoveEndpointByUnit Перемещает конечную точку текстового диапазона на заданное количество единиц текста в диапазоне всего документа.
IUIAutomationTextRange::RemoveFromSelection Удаляет диапазон текста из существующей коллекции выделенного текста в текстовом контейнере, который поддерживает несколько несвязанных выделений.
IUIAutomationTextRange::ScrollIntoView Заставляет элемент управления текстом прокручиваться до тех пор, пока диапазон текста не будет виден в окне просмотра.
IUIAutomationTextRange::Select Выбирает диапазон текста, соответствующий этому диапазону текста, и удаляет все предыдущие выделенные фрагменты. (IUIAutomationTextRange.Select)

Требования

Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationclient.h (включая UIAutomation.h)

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

Интерфейсы шаблонов элементов управления для клиентов

Поддержка автоматизации пользовательского интерфейса для текстового содержимого

Использование текстовых диапазонов