TextPatternRange.FindText(String, Boolean, Boolean) Methode

Definition

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

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