ITextRangeProvider.Move(TextUnit, Int32) Metodo

Definizione

Spazio dei nomi:

System.Windows.Automation.Provider

Assembly:

UIAutomationTypes.dll

Sposta l'intervallo di testo di un numero specificato di unità di testo.

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

Parametri

unit

TextUnit

Limite di unità di testo.

count

Int32

Numero di unità di testo da spostare.

Un valore positivo consente di spostare l'intervallo di testo in avanti, un valore negativo consente di spostare l'intervallo di testo indietro e 0 non ha effetto.

Restituisce

Int32

Numero di unità effettivamente spostate. Può essere inferiore al numero richiesto se uno dei nuovi endpoint di intervallo di testo è maggiore o minore degli endpoint di DocumentRange.

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 spostato avanti o indietro in DocumentRange per il numero richiesto di limiti unit .

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

Esempi di regolazione di un intervallo di testo per Move() ed ExpandToEnclosingUnit()

Il contenuto testuale (o testo interno) di un contenitore di testo e di un oggetto incorporato, ad esempio un collegamento ipertestuale o una cella di tabella, viene esposto come un singolo flusso di testo continuo sia nella visualizzazione controllo che nella visualizzazione contenuto dell'albero Automazione interfaccia utente; i limiti degli oggetti vengono ignorati.

Esempio di un flusso di testo con oggetti incorporati e le estensioni degli intervalli corrispondenti

Move rispetta sia il testo nascosto che quello visibile.

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

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

Il testo non viene modificato in alcun modo, l'intervallo di testo si estende solo su una parte diversa del testo.