Condividi tramite


ITextRangeProvider.MoveEndpointByUnit Metodo

Definizione

Sposta un endpoint dell'intervallo di testo del numero specificato di unità di testo nell'intervallo del 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

Parametri

endpoint
TextPatternRangeEndpoint

Endpoint da spostare.

unit
TextUnit

Unità testuale per lo spostamento.

count
Int32

Numero di unità da spostare. Un valore positivo comporta lo spostamento in avanti dell'endpoint. Un valore negativo comporta lo spostamento indietro. Un valore pari a 0 non ha effetto.

Restituisce

Numero di unità effettivamente spostate, che può essere inferiore al numero richiesto se con lo spostamento degli endpoint si raggiunge l'inizio o la fine del documento.

Commenti

Quando è necessario scorrere il contenuto di un intervallo di testo, per garantire una corretta esecuzione del metodo Move è prevista una serie di passaggi dietro le quinte.

  1. L'intervallo di testo viene normalizzato, ovvero viene compresso in un intervallo degenerato all'endpoint Start . Ciò rende superfluo l'endpoint End . Questo passaggio è necessario per rimuovere l'ambiguità nelle situazioni in cui un intervallo di testo si estende unit su limiti, ad esempio "{La riga https://www.microsoft.com/ U}è incorporata nel testo" in cui "{" e "}" sono gli endpoint dell'intervallo di testo.

  2. L'intervallo risultante viene spostato indietro in DocumentRange all'inizio del limite unit richiesto.

  3. L'intervallo viene quindi espanso dallo stato di intervallo degenerato spostando l'endpoint End di un limite unit richiesto.

Regolazioni dell'intervallo per Move & ExpandToEnclosingUnit
Esempi di regolazione di un intervallo di testo per Move() ed ExpandToEnclosingUnit()

MoveEndpointByUnit rinvia al successivo più grande TextUnit supportato se il dato TextUnit non è supportato dal controllo .

L'ordine, dall'unità più piccola alla più grande, è elencato di seguito.

Si applica a