TextPattern.IsReadOnlyAttribute Alan

Tanım

Ad Alanı:

System.Windows.Automation

Bütünleştirilmiş Kod:

UIAutomationClient.dll

Metin aralığının IsReadOnly özniteliğini tanımlar.

public: static initonly System::Windows::Automation::AutomationTextAttribute ^ IsReadOnlyAttribute;

public static readonly System.Windows.Automation.AutomationTextAttribute IsReadOnlyAttribute;

 staticval mutable IsReadOnlyAttribute : System.Windows.Automation.AutomationTextAttribute

Public Shared ReadOnly IsReadOnlyAttribute As AutomationTextAttribute 

Alan Değeri

AutomationTextAttribute

Örnekler

Aşağıdaki örnekte, Microsoft Not Defteri'nde 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'nin istenen öznitelik değerini desteklemesi garanti değildir.

private void GetIsReadOnlyAttribute()
{
    // 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.IsReadOnlyAttribute);
    if (oAttribute == TextPattern.MixedAttributeValue)
    {
        Console.WriteLine("Mixture of readonly and non-readonly.");
    }
    else
    {
        Console.WriteLine(oAttribute.ToString());
    }
}

Private Sub GetIsReadOnlyAttribute()
    ' 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.IsReadOnlyAttribute)
    If (oAttribute = TextPattern.MixedAttributeValue) Then
        Console.WriteLine("Mixture of readonly and non-readonly.")
    Else
        Console.WriteLine(oAttribute.ToString())
    End If
End Sub

Açıklamalar

Bu öznitelik, çağıran metin aralığıyla ilişkili belgenin salt okunur durumunu temsil eder.

Not

Bir belge veya dosya salt okunur durumdaysa ancak yine de belgeyi düzenleyip başka bir dosya olarak kaydedebilirseniz, metin salt okunur olarak kabul edilmez.

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 Boolean. false varsayılan değerdir.

Ayrıca bkz.

• TextPatternRange