Idioma

ITextRangeProvider.Move(TextUnit, Int32) Método

Definição

Namespace:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assemblies:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

Move o intervalo de texto o número especificado de unidades de texto.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);
public int Move(System.Windows.Automation.Text.TextUnit unit, int count);
abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int
Public Function Move (unit As TextUnit, count As Integer) As Integer

Parâmetros

unit
TextUnit

O limite da unidade de texto.

count
Int32

O número de unidades de texto a serem movidas.

Um valor positivo move o intervalo de texto para frente, um valor negativo move o intervalo de texto para trás e 0 não tem efeito.

Retornos

Int32

O número de unidades realmente movidas. Isso pode ser menor do que o número solicitado se um dos novos pontos de extremidade do intervalo de texto for maior ou menor que os DocumentRange pontos de extremidade.

Comentários

Quando é necessário percorrer o conteúdo de um intervalo de texto, uma série de etapas são 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, tornando 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 até o início do limite solicitado unit.

  3. O intervalo é movido para frente ou para trás no DocumentRange pelo 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.

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

O conteúdo textual (ou texto interno) de um contêiner de texto e um objeto inserido, como um hiperlink ou célula de tabela, é exposto como um único fluxo de texto contínuo no modo de exibição de controle e na exibição de conteúdo da árvore de Automação da Interface do Usuário; os limites de objeto são ignorados.

Intervalos de texto estendidos por objetos inseridos. Exemplo de um fluxo de texto com objetos inseridos e seus intervalos

Move respeita o texto oculto e visível.

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

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

O texto não é alterado de forma alguma, o intervalo de texto abrange apenas uma parte diferente do texto.

Aplica-se a