Freigeben über


TextPatternRange.GetAttributeValue(AutomationTextAttribute) Methode

Definition

Gibt den Wert des angegebenen Attributs für den gesamten Textbereich zurück.

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

Parameter

attribute
AutomationTextAttribute

Das Textattribut.

Gibt zurück

Gibt den Wert des angegebenen Attributs zurück. Zum Beispiel gibt „GetAttributeValue(TextPattern.FontNameAttribute)“ eine Zeichenfolge zurück, die den Schriftartnamen für den Textbereich darstellt, sofern dieser eindeutig ist, während „GetAttributeValue(TextPattern.IsItalicAttribute)“ einen booleschen Wert zurückgibt.

Gibt MixedAttributeValue zurück, wenn sich der Wert des angegebenen Attributs im Verlauf des Textbereichs ändert.

Gibt NotSupported zurück, wenn das angegebene Attribut vom Anbieter oder Steuerelement nicht unterstützt wird.

Ausnahmen

Wenn das angegebene Attribut nicht gültig ist.

Beispiele

 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

Hinweise

Es gibt keine Unterscheidung zwischen ausgeblendetem und sichtbarem Text. Benutzeroberflächenautomatisierungsclients können verwenden IsHiddenAttribute , um die Textsichtbarkeit zu überprüfen.

Gilt für: