Метод ITextRangeProvider::ExpandToEnclosingUnit (uiautomationcore.h)
Нормализует диапазон текста по заданной единице текста. Диапазон расширяется, если он меньше указанной единицы, или сокращается, если он длиннее указанной единицы.
Синтаксис
HRESULT ExpandToEnclosingUnit(
[in] TextUnit unit
);
Параметры
[in] unit
Тип: TextUnit
Тип текстовых единиц, таких как символ, слово, абзац и т. д.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Клиентские приложения, такие как средства чтения с экрана, используют этот метод для получения полного слова, предложения или абзаца, которые существуют в точке вставки или позиции курсора.
Несмотря на свое имя, метод ITextRangeProvider::ExpandToEnclosingUnit не обязательно расширяет текстовый диапазон. Вместо этого он "нормализует" текстовый диапазон, перемещая конечные точки таким образом, чтобы диапазон охватывал указанную текстовую единицу. Диапазон расширяется, если он меньше указанной единицы, или сокращается, если он длиннее указанной единицы. Если диапазон уже является точным количеством указанных единиц, он остается неизменным. Крайне важно, чтобы метод ExpandToEnclosingUnit всегда согласованно нормализовал текстовые диапазоны; в противном случае другие аспекты обработки диапазона текста единицами текста будут непредсказуемыми. На следующей схеме показано, как ExpandToEnclosingUnit нормализует текстовый диапазон путем перемещения конечных точек диапазона.
ExpandToEnclosingUnit по умолчанию использует следующую самую большую поддерживаемую текстовую единицу, если указанная текстовая единица не поддерживается элементом управления.
Порядок от наименьшей единицы к наибольшему выглядит следующим образом:
- Символ
- Формат
- Word
- Линия
- Paragraph
- Страница
- Document
Поведение диапазона при значении единицы измеренияTextUnit::Format
TextUnit::Format как значение единицы позиционирует границу текстового диапазона для расширения или перемещения диапазона на основе атрибутов общего текста (формата) текста в диапазоне. Однако при использовании текстового блока форматирования не следует перемещать или разворачивать текстовый диапазон через границу внедренного объекта, например изображения или гиперссылки. Дополнительные сведения см. в разделе Единицы текста модели автоматизации пользовательского интерфейса или Шаблоны элементов управления Text и TextRange.
Требования
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | uiautomationcore.h (включая UIAutomation.h) |
См. также раздел
Основные понятия
Справочные материалы
Шаблоны элементов управления Text и TextRange
Общие сведения о поставщиках автоматизации пользовательского интерфейса