TextPatternRange.GetText(Int32) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation.Text

Zestaw:

UIAutomationClient.dll

Zwraca zwykły tekst zakresu tekstu.

public:
 System::String ^ GetText(int maxLength);

public string GetText (int maxLength);

member this.GetText : int -> string

Public Function GetText (maxLength As Integer) As String

Parametry

maxLength

Int32

Maksymalna długość ciągu do zwrócenia. Użyj -1 polecenia , jeśli nie jest wymagany limit.

Zwraca

String

Zwykły tekst zakresu tekstu, prawdopodobnie obcięty w określonym maxLengthobiekcie .

Wyjątki

ArgumentOutOfRangeException

Jeśli maxLength wartość jest mniejsza niż -1.

Przykłady

 private String TextFromSelection(AutomationElement target, Int32 length)
{
    // 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 null;
    }
    TextPatternRange[] currentSelection = textpatternPattern.GetSelection();

    // GetText(-1) retrieves all characters but can be inefficient
    return currentSelection[0].GetText(length);
}

Private Function TextFromSelection(ByVal target As AutomationElement, ByVal length As Int32) As String
    ' 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 Nothing
    End If
    Dim currentSelection As TextPatternRange() = textpatternPattern.GetSelection()
    ' GetText(-1) retrieves all characters but can be inefficient
    Return currentSelection(0).GetText(length)
End Function

Uwagi

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

Jeśli maxLength długość zakresu tekstu obiektu wywołującego jest większa, zwracany ciąg będzie zwykłym tekstem zakresu tekstu.

GetText nie będzie mieć wpływu na kolejność punktów końcowych w przepływie tekstu; Zawsze zwraca tekst między punktami końcowymi początkowymi i końcowymi zakresu tekstu w kolejności przepływu tekstu logicznego.

Zobacz też

• TextPatternRangeEndpoint