Freigeben über


ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Methode

Definition

Erweitert den Textbereich auf die angegebene Texteinheit.

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)

Parameter

unit
TextUnit

Die Texteinheit.

Hinweise

Wenn der Bereich bereits eine exakte Menge der angegebenen Einheiten ist, bleibt er unverändert.

Hinter den Kulissen sind eine Reihe von Schritten erforderlich, damit die Move Methode erfolgreich ausgeführt werden kann.

  1. Der Textbereich ist normalisiert. Dies bedeutet, dass dieser auf einen degenerierten Bereich am Start -Endpunkt reduziert ist, wodurch der End -Endpunkt überflüssig wird. Dieser Schritt ist erforderlich, um Mehrdeutigkeiten in Situationen zu entfernen, in denen sich ein Textbereich über Grenzen erstreckt unit , z. B. "{The U}RL https://www.microsoft.com/ is embedded in text", wobei "{" und "}" die Textbereichsendpunkte sind.

  2. Der resultierende Bereich wird im DocumentRange zurück an den Anfang der angeforderten unit -Grenze verschoben.

  3. Der Bereich wird um die angeforderte Anzahl von DocumentRange -Grenzen nach vorne oder nach hinten im unit verschoben.

  4. Anschließend wird der Bereich von einem degenerierten Bereichszustand erweitert, indem der End -Endpunkt um eine angeforderte unit -Grenze verschoben wird.

Bereichsanpassungen durch Move & ExpandToEnclosingUnit
Beispiele für die Anpassung eines Textbereichs für Move() und ExpandToEnclosingUnit()

Hinweis

Diese Schritte sind erforderlich, da es üblich ist, dass eine Sprachausgabe ein vollständiges Wort, einen Satz oder einen ganzen Absatz an der Einfügemarke oder einer beliebigen virtuellen Cursorposition ausliest.

ExpandToEnclosingUnit berücksichtigt ausgeblendeten und sichtbaren Text.

ExpandToEnclosingUnit wird auf die nächstgrößer TextUnit unterstützte zurückversetzt, wenn die angegebene TextUnit vom -Steuerelement nicht unterstützt wird.

Die Reihenfolge, von der kleinsten Einheit bis zur größten, ist unten aufgeführt.

Gilt für: