TextPatternRange.GetAttributeValue(AutomationTextAttribute) Метод

Определение

Пространство имен:

System.Windows.Automation.Text

Сборка:

UIAutomationClient.dll

Возвращает значение заданного атрибута для всего текстового диапазона.

public:
 System::Object ^ GetAttributeValue(System::Windows::Automation::AutomationTextAttribute ^ attribute);

public object GetAttributeValue (System.Windows.Automation.AutomationTextAttribute attribute);

member this.GetAttributeValue : System.Windows.Automation.AutomationTextAttribute -> obj

Public Function GetAttributeValue (attribute As AutomationTextAttribute) As Object

Параметры

attribute

AutomationTextAttribute

Атрибут текста.

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

Object

Возвращает значение заданного атрибута. Например, GetAttributeValue(TextPattern.FontNameAttribute) вернет строку, представляющую имя шрифта, если он един для всего текстового диапазона, а GetAttributeValue(TextPattern.IsItalicAttribute) вернет значение логического типа.

Возвращает MixedAttributeValue, если значение заданного атрибута различается в пределах текстового диапазона.

Возвращает NotSupported, если заданный атрибут не поддерживается поставщиком или элементом управления.

Исключения

ArgumentException

Если указанный атрибут недопустим.

Примеры

 private Object AttributeValueFromSelection(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[] currentSelection = textpatternPattern.GetSelection();
    // Is 'italic'?
    return currentSelection[0].GetAttributeValue(TextPattern.IsItalicAttribute);
}

Private Function AttributeValueFromSelection(ByVal target As AutomationElement) As Object
    ' 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()
    ' Is 'italic'?
    Return currentSelection(0).GetAttributeValue(TextPattern.IsItalicAttribute)
End Function

Комментарии

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