ITextRangeProvider.Move(TextUnit, Int32) Metodo

Definizione

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

Sposta l'intervallo di testo il 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 dell'unità di testo.

count
Int32

Numero di unità di testo da spostare.

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

Valori restituiti

Int32

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

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

  4. 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()

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

Intervalli di testo compresi in oggetti incorporati. Esempio di flusso di testo con oggetti incorporati e intervallo

Move rispetta sia il testo nascosto che il testo visibile.

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

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

Si applica a