ITextRangeProvider.Move(TextUnit, Int32) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Automation.Provider

Assembly:: UIAutomationProvider.dll

Assembly:: UIAutomationProvider.dll, UIAutomationTypes.dll

Assembly:: UIAutomationTypes.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

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.
L'intervallo risultante viene spostato indietro in DocumentRange all'inizio del limite unit richiesto.
L'intervallo viene spostato avanti o indietro in DocumentRange per il numero richiesto di limiti unit .
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()

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.

Intervalli di testo inclusi in oggetti incorporati.
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.

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

Si applica a

Condividi tramite