TextPatternRange.GetAttributeValue(AutomationTextAttribute) Método

Definição

Retorna o valor do atributo especificado em todo o intervalo de texto.

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

Parâmetros

attribute
AutomationTextAttribute

O atributo de texto.

Retornos

Retorna o valor do atributo especificado. Por exemplo, GetAttributeValue(TextPattern.FontNameAttribute) retornaria uma cadeia de caracteres que representa o nome da fonte, se for único, do intervalo de texto, ao passo que GetAttributeValue(TextPattern.IsItalicAttribute) retornaria um booliano.

Retorna MixedAttributeValue se o valor do atributo especificado varia ao longo do intervalo de texto.

Retorna NotSupported se o atributo especificado não for compatível com o provedor ou com o controle.

Exceções

Se o atributo especificado não for válido.

Exemplos

 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);
}

Comentários

Não há nenhuma diferenciação entre texto oculto e visível. Os clientes de Automação da Interface do Usuário podem usar IsHiddenAttribute para marcar visibilidade do texto.

Aplica-se a

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9