TextPattern.IsReadOnlyAttribute Campo

Definição

Espaço de Nomes:
System.Windows.Automation
Assemblagem:
UIAutomationClient.dll

Identifica o IsReadOnly atributo de um intervalo de texto.

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

Valor de Campo

AutomationTextAttribute

Exemplos

O exemplo seguinte mostra como obter um valor de atributo para um intervalo de texto no Microsoft Notepad.

Note

O Microsoft Notepad é usado apenas como fornecedor de texto para fins de exemplo. O Microsoft Notepad não garante que suporte o valor de atributo solicitado.

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

Observações

Este atributo representa o estado de somente leitura do documento associado ao intervalo de texto que chama.

Note

Se um documento ou ficheiro for só leitura, mas ainda puder editá-lo e guardá-lo como outro ficheiro, o texto não é considerado apenas leitura.

Este identificador é utilizado por aplicações clientes de Automatização da Interface de Utilizador. Automatização da Interface de Utilizador prestadores devem usar o campo equivalente em TextPatternIdentifiers.

Automatização da Interface de Utilizador clientes obtêm o valor do atributo chamando GetAttributeValue.

Os valores deste atributo são do tipo Boolean. O valor predefinido é false.

Aplica-se a

Ver também