TextPatternRange.FindText(String, Boolean, Boolean) Метод

Ссылка

Определение

Пространство имен:: System.Windows.Automation.Text

Сборка:: UIAutomationClient.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает подмножество текстового диапазона, содержащее заданный текст.

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

Параметры

text: String

Искомая текстовая строка.

backward: Boolean

Значение true, если вместо первого должно быть возвращено последнее вхождение текстового диапазона; в противном случае — false.

ignoreCase: Boolean

Значение true, если регистр следует игнорировать; в противном случае — false.

Возвращаемое значение

TextPatternRange

Текстовый диапазон, соответствующий заданному тексту; в противном случае — NULL (Nothing в Visual Basic).

Примеры

 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

Различия между скрытым и видимым текстом не различаются. Клиенты автоматизации пользовательского интерфейса могут использовать IsHiddenAttribute для проверка видимости текста.

Примечание

Используйте DocumentRange для поиска во всем документе.

Применяется к

См. также раздел

TextPattern