TextPatternRange.GetAttributeValue(AutomationTextAttribute) Metoda

Reference

Definice

Obor názvů:: System.Windows.Automation.Text

Sestavení:: UIAutomationClient.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí hodnotu zadaného atributu v celém rozsahu textu.

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

Parametry

attribute: AutomationTextAttribute

Atribut text.

Návraty

Object

Vrátí hodnotu zadaného atributu. Například GetAttributeValue(TextPattern.FontNameAttribute) vrátí řetězec, který představuje název písma, pokud je jedinečný, textového rozsahu, zatímco GetAttributeValue(TextPattern.IsItalicAttribute) vrátí logickou hodnotu.

Vrátí MixedAttributeValue , pokud se hodnota zadaného atributu liší v rozsahu textu.

Vrátí NotSupported , pokud zadaný atribut není podporován zprostředkovatelem nebo ovládacím prvku.

Výjimky

ArgumentException

Pokud zadaný atribut není platný.

Příklady

 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

Poznámky

Mezi skrytým a viditelným textem není žádný rozdíl. Klienti automatizace uživatelského rozhraní můžou použít IsHiddenAttribute ke kontrole viditelnosti textu.

Platí pro

Sdílet prostřednictvím