TextPatternRange.GetText(Int32) Metodo

Definizione

Spazio dei nomi:
System.Windows.Automation.Text
Assembly:
UIAutomationClient.dll

Restituisce il testo normale dell'intervallo di testo.

public:
 System::String ^ GetText(int maxLength);
public string GetText(int maxLength);
member this.GetText : int -> string
Public Function GetText (maxLength As Integer) As String

Parametri

maxLength
Int32

Lunghezza massima della stringa da restituire. Usare -1 se non è necessario alcun limite.

Valori restituiti

String

Testo normale dell'intervallo di testo, possibilmente troncato in corrispondenza dell'oggetto specificato maxLength.

Eccezioni

ArgumentOutOfRangeException

Se maxLength è minore di -1.

Esempio

 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

Commenti

GetText rispetta sia il testo nascosto che il testo visibile. Il client Automazione interfaccia utente può controllare la visibilità del testo IsHiddenAttribute.

Se maxLength è maggiore della lunghezza dell'intervallo di testo del chiamante, la stringa restituita sarà il testo normale dell'intervallo di testo.

GetText non sarà interessato dall'ordine degli endpoint nel flusso di testo; restituisce sempre il testo tra gli endpoint iniziale e finale dell'intervallo di testo nell'ordine del flusso di testo logico.

Si applica a

Vedi anche