ITextRangeProvider.Move(TextUnit, Int32) Método

Definição

Espaço de Nomes:
System.Windows.Automation.Provider
Assemblagem:
UIAutomationProvider.dll
Assemblagens:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assemblagem:
UIAutomationTypes.dll

Move o intervalo de texto para 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 mover.

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

Devoluções

Int32

O número de unidades realmente se moviam. Isto pode ser inferior ao número solicitado se qualquer um dos novos terminais do intervalo de texto for maior ou menor que os DocumentRange terminais.

Observações

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 sucesso.

  1. O intervalo de texto é normalizado; ou seja, o intervalo de texto é recolhido para um intervalo degenerado no Start ponto de extremidade, o que torna o End ponto de extremidade supérfluo. Este passo é necessário para remover ambiguidade em situações em que um intervalo de texto atravessa unit fronteiras; por exemplo, "{O U}RL https://www.microsoft.com/ está incorporado no texto" onde "{" e "}" são os extremos 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 a frente ou para trás no DocumentRange pelo número solicitado de unit limites.

  4. O intervalo é então expandido a partir de um estado degenerado de intervalo, movendo o ponto de extremidade End por um limite unit solicitado.

Ajustes de alcance por Mover & Expandir ParaAjustamentos de Alcance da Unidade 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 incorporado, como um hiperlink ou célula de tabela, é exposto como um fluxo de texto único e contínuo na exibição de controle e na exibição de conteúdo da árvore de Automação da Interface do Usuário; Os limites do objeto são ignorados.

Intervalos de texto abrangidos por objetos embutidos. Exemplo de um fluxo de texto com objetos embutidos e os seus abrangências de alcance

Move respeita tanto o texto oculto como o visível.

Move adia para o próximo maior TextUnit suporte se o dado TextUnit não for suportado pelo controlo.

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

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

Aplica-se a