Интерфейс 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) |
См. также раздел
Интерфейсы шаблонов элементов управления для клиентов
Поддержка автоматизации пользовательского интерфейса для текстового содержимого