ITextRangeProvider.MoveEndpointByUnit Metodo

Definizione

Spazio dei nomi:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assembly:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

Sposta un endpoint dell'intervallo di testo il numero specificato di unità di testo all'interno dell'intervallo di documenti.

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 sposta l'endpoint in avanti. Un valore negativo si sposta all'indietro. Il valore 0 non ha alcun effetto.

Valori restituiti

Int32

Numero di unità effettivamente spostate, che possono essere inferiori al numero richiesto se lo spostamento dell'endpoint viene eseguito all'inizio o alla fine del documento.

Commenti

Quando è necessario attraversare il contenuto di un intervallo di testo, viene coinvolta una serie di passaggi in background affinché il Move metodo venga eseguito correttamente.

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

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

  3. L'intervallo viene quindi espanso da uno stato degenerato dell'intervallo spostando l'endpoint End di un limite specificato unit.

Regolazioni di intervallo in base a Move & ExpandToEnclosingUnit Esempi di regolazione di un intervallo di testo per Move() e ExpandToEnclosingUnit()

MoveEndpointByUnit rinvia al successivo più grande TextUnit supportato se l'oggetto specificato TextUnit non è supportato dal controllo .

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

Si applica a