TextPatternRange.FindText(String, Boolean, Boolean) Methode

Referenz

Definition

Namespace:: System.Windows.Automation.Text

Assembly:: UIAutomationClient.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den Teil des Textbereichs zurück, der den angegebenen Text enthält.

public:
 System::Windows::Automation::Text::TextPatternRange ^ FindText(System::String ^ text, bool backward, bool ignoreCase);

public System.Windows.Automation.Text.TextPatternRange FindText (string text, bool backward, bool ignoreCase);

member this.FindText : string * bool * bool -> System.Windows.Automation.Text.TextPatternRange

Public Function FindText (text As String, backward As Boolean, ignoreCase As Boolean) As TextPatternRange

Parameter

text: String

Die zu suchende Textzeichenfolge.

backward: Boolean

true, wenn statt dem ersten der letzte vorhandene Textbereich zurückgegeben werden soll, andernfalls false.

ignoreCase: Boolean

true, wenn die Groß-/Kleinschreibung ignoriert werden soll, andernfalls false.

Gibt zurück

TextPatternRange

Ein Textbereich, der mit dem angegebenen Text übereinstimmt, andernfalls NULL (Nothing in Visual Basic).

Beispiele

 private TextPatternRange TextFromSelection(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 null;
    }
    TextPatternRange[] tprSelection = textpatternPattern.GetSelection();
    // Find 'text' in selection range
    return tprSelection[0].FindText("text", false, true);
}

Private Function TextFromSelection(ByVal target As AutomationElement) As TextPatternRange
    ' 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()
    ' Find 'text' in selection range
    Return currentSelection(0).FindText("text", False, True)
End Function

Hinweise

Es gibt keine Unterscheidung zwischen ausgeblendetem und sichtbarem Text. Benutzeroberflächenautomatisierungsclients können verwenden IsHiddenAttribute , um die Textsichtbarkeit zu überprüfen.

Hinweis

Verwenden Sie DocumentRange , um das gesamte Dokument zu durchsuchen.

Gilt für:

Weitere Informationen

TextPattern

Freigeben über