ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Methode

Definition

Namespace:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll
Assemblys:
UIAutomationProvider.dll, UIAutomationTypes.dll
Assembly:
UIAutomationTypes.dll

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 genaue Menge der angegebenen Einheiten ist, bleibt er unverändert.

Es gibt eine Reihe von Schritten im Hintergrund, damit die Move Methode erfolgreich ausgeführt werden kann.

  1. Der Textbereich wird normalisiert; d. h. der Textbereich wird auf einen degenerierten Bereich am Start Endpunkt reduziert, wodurch der End Endpunkt überflüssig wird. Dieser Schritt ist erforderlich, um Mehrdeutigkeit in Situationen zu entfernen, in denen ein Textbereich Grenzen umfasst unit , z. B. "{Die U}RL https://www.microsoft.com/ ist in Text eingebettet", wobei "{" und "}" die Endpunkte des Textbereichs 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. Der Bereich wird dann 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()

Note

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 an einer beliebigen virtuellen Cursorposition vorliest.

ExpandToEnclosingUnit berücksichtigt ausgeblendeten und sichtbaren Text.

ExpandToEnclosingUnit Wird auf die nächstgrößte TextUnit unterstützung zurückverzögert, wenn das angegebene TextUnit Steuerelement nicht unterstützt wird.

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

Gilt für: