ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Metodo

Definizione

Espande l'intervallo di testo all'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 dietro le quinte per consentire l'esecuzione corretta del Move metodo.

  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.

Regolazioni dell'intervallo per Move & ExpandToEnclosingUnit
Esempi di regolazione di un intervallo di testo per Move() ed ExpandToEnclosingUnit()

Nota

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

ExpandToEnclosingUnit rispetta sia il testo nascosto che quello visibile.

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

Si applica a