TextPatternRange.GetAttributeValue(AutomationTextAttribute) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation.Text

Bütünleştirilmiş Kod:

UIAutomationClient.dll

Metin aralığının tamamında belirtilen özniteliğin değerini döndürür.

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

Parametreler

attribute

AutomationTextAttribute

text özniteliği.

Döndürülenler

Object

Belirtilen özniteliğin değerini döndürür. Örneğin, GetAttributeValue(TextPattern.FontNameAttribute) metin aralığının benzersizse yazı tipi adını temsil eden bir dize döndürürken, GetAttributeValue(TextPattern.IsItalicAttribute) boole değeri döndürür.

Belirtilen özniteliğin değeri metin aralığına göre değişirse döndürür MixedAttributeValue .

Belirtilen öznitelik sağlayıcı veya denetim tarafından desteklenmiyorsa döndürür NotSupported .

Özel durumlar

ArgumentException

Belirtilen öznitelik geçerli değilse.

Örnekler

 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

Açıklamalar

Gizli ve görünür metin arasında bir fark yoktur. UI Otomasyonu istemcileri metin görünürlüğünü denetlemek için kullanabilir IsHiddenAttribute .