Linguaggio

ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metodo

Definizione

Espande l'intervallo di testo nell'unità di testo specificata.

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);
public void ExpandToEnclosingUnit(System.Windows.Automation.Text.TextUnit unit);
abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit
Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Parametri

unit
TextUnit

Unità testuale.

Commenti

Se l'intervallo è già una quantità esatta delle unità specificate, rimane invariata.

Sono necessari 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()

Note

Questi passaggi sono necessari poiché è comune per un'utilità per la lettura dello schermo leggere una parola, una frase o un intero paragrafo nel punto di inserimento o in qualsiasi posizione del cursore virtuale.

ExpandToEnclosingUnit rispetta sia il testo nascosto che il testo visibile.

ExpandToEnclosingUnit 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