TextPatternRange.ExpandToEnclosingUnit(TextUnit) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Text

Zestaw:

UIAutomationClient.dll

Rozwija zakres tekstu do określonego TextUnitelementu .

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);

public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);

member this.ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit

Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Parametry

unit

TextUnit

Jednostka tekstowa.

Przykłady

 private void ExpandSelection(AutomationElement target)
{
    // Specify the control type we're looking for, in this case 'Document'
    PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

    // target --> The root AutomationElement.
    AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

    TextPattern textpatternPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

    if (textpatternPattern == null)
    {
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
        return;
    }
    TextPatternRange[] currentSelection = textpatternPattern.GetSelection();
    // Expand selection to include entire document
    currentSelection[0].ExpandToEnclosingUnit(TextUnit.Document);
}

Private Sub ExpandSelection(ByVal target As AutomationElement)
    ' Specify the control type we're looking for, in this case 'Document'
    Dim cond As PropertyCondition = New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document)

    ' target --> The root AutomationElement.
    Dim textProvider As AutomationElement = target.FindFirst(TreeScope.Descendants, cond)

    Dim textpatternPattern As TextPattern = CType(textProvider.GetCurrentPattern(TextPattern.Pattern), TextPattern)

    If (textpatternPattern Is Nothing) Then
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.")
        Return
    End If
    Dim currentSelection As TextPatternRange() = textpatternPattern.GetSelection()
    currentSelection(0).ExpandToEnclosingUnit(TextUnit.Document)
End Sub

Uwagi

Jeśli zakres jest już dokładną ilością określonych jednostek, pozostaje niezmieniony.

Aby ExpandToEnclosingUnit metoda została wykonana pomyślnie, sekwencja akcji jest wykonywana w tle.

1. Zakres tekstu jest znormalizowany; oznacza to, że zakres tekstu jest zwinięty do zakresu degeneracji w Start punkcie końcowym, co sprawia, że End punkt końcowy jest zbędny. Ten krok jest niezbędny do usunięcia niejednoznaczności w sytuacjach, w których zakres tekstu obejmuje unit granice, na przykład "{Lista U}RL https://www.microsoft.com/ jest osadzona w tekście", gdzie "{" i "}" są punktami końcowymi zakresu tekstu.

2. Wynikowy zakres jest przesuwany do tyłu DocumentRange na początku żądanej unit granicy.

3. Zakres jest przesuwany do przodu lub do tyłu DocumentRange przez żądaną liczbę unit granic.

4. Zakres jest następnie rozszerzany z zdegenerowanego stanu zakresu przez przeniesienie End punktu końcowego przez jedną żądaną granicę unit .

Przykłady dostosowania zakresu tekstu dla funkcji Move() i ExpandToEnclosingUnit()

Uwaga

Te kroki są niezbędne, ponieważ czytnik zawartości ekranu często odczytuje pełne słowo, zdanie lub cały akapit w punkcie wstawiania lub dowolne wirtualne położenie kursora.

ExpandToEnclosingUnit uwzględnia zarówno tekst ukryty, jak i widoczny. Klient automatyzacja interfejsu użytkownika może sprawdzić IsHiddenAttribute widoczność tekstu.

ExpandToEnclosingUnit odchyli wartość do następnego największego TextUnit obsługiwanego, jeśli dana TextUnit wartość nie jest obsługiwana przez kontrolkę.

Kolejność, od najmniejszej do największej jednostki, znajduje się poniżej.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

Zobacz też

• TextPatternRangeEndpoint