ITextRangeProvider.MoveEndpointByUnit Método

Definição

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

Move um extremo do intervalo de texto para o número especificado de unidades de texto dentro do intervalo do documento.

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

Parâmetros

endpoint
TextPatternRangeEndpoint

O ponto final para avançar.

unit
TextUnit

A unidade textual para a mudança.

count
Int32

O número de unidades a mover. Um valor positivo move o ponto final para a frente. Um valor negativo move-se para trás. Um valor de 0 não tem efeito.

Devoluções

Int32

O número de unidades efetivamente movimentadas, que pode ser inferior ao número solicitado se mover o endpoint entrar no início ou no fim do documento.

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 é 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()

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

Aplica-se a