TextPattern.ForegroundColorAttribute Alan

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Automation
Bütünleştirilmiş Kod:
UIAutomationClient.dll

Bir metin aralığının ForegroundColor (COLORREF) özniteliğini tanımlar.

public: static initonly System::Windows::Automation::AutomationTextAttribute ^ ForegroundColorAttribute;
public static readonly System.Windows.Automation.AutomationTextAttribute ForegroundColorAttribute;
 staticval mutable ForegroundColorAttribute : System.Windows.Automation.AutomationTextAttribute
Public Shared ReadOnly ForegroundColorAttribute As AutomationTextAttribute

Alan Değeri

AutomationTextAttribute

Örnekler

Aşağıdaki örnekte, Microsoft Not Defteri'da bir metin aralığı için öznitelik değerinin nasıl alın aldığı gösterilmektedir.

Not

Microsoft Not Defteri metin sağlayıcısı olarak yalnızca amaçlar için kullanılır. Microsoft Not Defteri istenen öznitelik değerini desteklemesi garanti değildir.

private void GetForegroundColorAttribute()
{
    // Start application.
    Process p = Process.Start("Notepad.exe", "text.txt");

    // target --> The root AutomationElement.
    AutomationElement target = AutomationElement.FromHandle(p.MainWindowHandle);

    // Specify the control type we're looking for, in this case 'Document'
    PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

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

    Object oAttribute = textpatternPattern.DocumentRange.GetAttributeValue(TextPattern.ForegroundColorAttribute);
    if (oAttribute == TextPattern.MixedAttributeValue)
    {
        Console.WriteLine("Mixed foreground colors.");
    }
    else
    {
        Console.WriteLine(oAttribute.ToString());
    }
}

Private Sub GetForegroundColorAttribute()
    ' Start application.
    Dim p As Process = Process.Start("Notepad.exe", "text.txt")

    ' target --> The root AutomationElement.
    Dim target As AutomationElement = AutomationElement.FromHandle(p.MainWindowHandle)

    ' Specify the control type we're looking for, in this case 'Document'
    Dim cond As PropertyCondition = New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document)

    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
    End If

    Dim oAttribute As Object = textpatternPattern.DocumentRange.GetAttributeValue(TextPattern.ForegroundColorAttribute)
    If (oAttribute = TextPattern.MixedAttributeValue) Then
        Console.WriteLine("Mixed foreground colors.")
    Else
        Console.WriteLine(oAttribute.ToString())
    End If
End Sub

Açıklamalar

Bu özniteliğin değeri metin veya yazı tipi rengiyle eşdeğerdir.

Bu tanımlayıcı, UI Otomasyonu istemci uygulamaları tarafından kullanılır. UI Otomasyonu sağlayıcıları içindeki TextPatternIdentifierseşdeğer alanı kullanmalıdır.

UI Otomasyonu istemcileri çağırarak GetAttributeValueözniteliğinin değerini alır.

Bu özniteliğin değerleri türündedir Int32. zero varsayılan değerdir.

Şunlara uygulanır

Ayrıca bkz.