ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Método

Definição

Namespace:

System.Windows.Automation.Provider

Assembly:

UIAutomationTypes.dll

Expande o intervalo de texto para a unidade de texto especificada.

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)

Parâmetros

unit

TextUnit

A unidade textual.

Comentários

Se o intervalo já for uma quantidade exata das unidades especificadas, ele permanecerá inalterado.

Há uma série de etapas envolvidas nos bastidores para que o Move método seja executado com êxito.

1. O intervalo de texto é normalizado; ou seja, ele é recolhido a um intervalo degenerado no ponto de extremidade Start, o que torna o ponto de extremidade End supérfluo. Esta etapa é necessária para remover a ambiguidade em situações em que um intervalo de texto abrange unit limites; por exemplo, "{A U}RL https://www.microsoft.com/ está inserida no texto" em que "{" e "}" são os pontos de extremidade do intervalo de texto.

2. O intervalo resultante é movido para trás no DocumentRange para o início do limite unit solicitado.

3. O intervalo é movido para frente ou para trás no DocumentRange o número solicitado de limites unit.

4. Em seguida, o intervalo é expandido de um estado de intervalo degenerado movendo o ponto de extremidade End um limite unit solicitado.

Exemplos de como um intervalo de texto é ajustado para Move() e ExpandToEnclosingUnit()

Observação

Essas etapas são necessárias, pois é comum que um leitor de tela leia uma palavra completa, uma frase ou um parágrafo inteiro no ponto de inserção ou em qualquer posição de cursor virtual.

ExpandToEnclosingUnit respeita o texto oculto e visível.

ExpandToEnclosingUnit adiará para o próximo maior TextUnit com suporte se o determinado TextUnit não tiver suporte do controle .

A ordem, da menor unidade para a maior, está listada abaixo.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document