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

ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Automation.Provider
Сборка:
UIAutomationProvider.dll
Сборки:
UIAutomationProvider.dll, UIAutomationTypes.dll
Сборка:
UIAutomationTypes.dll

Расширяет текстовый диапазон до заданной единицы текста.

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);
public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);
abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit
Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Параметры

unit
TextUnit

Единица текста.

Комментарии

Если диапазон уже является точным количеством указанных единиц, он остается неизменным.

Существует ряд шагов, которые выполняются в фоновом режиме, Move чтобы метод успешно выполнился.

  1. Текстовый диапазон нормализован, т. е. он свернут до вырожденного диапазона в конечной точке Start , что делает конечную точку End избыточной. Этот шаг необходим для устранения неоднозначности в ситуациях, когда текстовый диапазон охватывает границы unit ; например, "{U}RL https://www.microsoft.com/ внедрен в текст", где "{" и "}" являются конечными точками диапазона текста.

  2. Результирующий диапазон перемещается в DocumentRange в начало запрошенной границы unit .

  3. Диапазон перемещается вперед или назад в DocumentRange на запрошенное число границ unit .

  4. Затем диапазон расширяется из вырожденного состояния путем перемещения конечной точки End на одну запрошенную границу unit .

Корректировки диапазона по move & ExpandToEnclosingUnit
Примеры корректировки текстового диапазона для Move() и ExpandToEnclosingUnit()

Примечание

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

ExpandToEnclosingUnit учитывает как скрытый, так и видимый текст.

ExpandToEnclosingUnit откладывает до следующего по величине TextUnit поддерживаемого, если заданный TextUnit не поддерживается элементом управления .

Ниже приведен порядок от наименьшей единицы до наибольшего.

Применяется к