ITextRangeProvider.MoveEndpointByUnit Método

  • Referência

Definição

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

Move um ponto de extremidade do intervalo de texto conforme 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 de extremidade a ser movido.

unit
TextUnit

A unidade textual para mover.

count
Int32

O número de unidades a serem movidas. Um valor positivo move o ponto de extremidade para a frente. Um valor negativo move-o para trás. Um valor de 0 não tem nenhum efeito.

Retornos

Int32

O número de unidades realmente movidos, que pode ser menor que o número solicitado se mover que o ponto de extremidade é executado no início ou no final do documento.

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 método Move 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. 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()

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

Aplica-se a