TextPatternRange.GetAttributeValue(AutomationTextAttribute) Metod

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

Parametrar

Returer

Returnerar värdet för det angivna attributet. GetAttributeValue(TextPattern.FontNameAttribute) skulle till exempel returnera en sträng som representerar teckensnittsnamnet, om det är unikt, för textintervallet medan GetAttributeValue(TextPattern.IsItalicAttribute) returnerar ett booleskt värde.

Returnerar MixedAttributeValue om värdet för det angivna attributet varierar över textintervallet.

Returnerar NotSupported om det angivna attributet inte stöds av providern eller kontrollen.

Undantag

Exempel

 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

Kommentarer

Det finns ingen differentiering mellan dold och synlig text. UI Automation klienter kan använda IsHiddenAttribute för att kontrollera textens synlighet.