TextPattern.IsReadOnlyAttribute Campo

Definição

Identifica o atributo IsReadOnly de um intervalo de texto.Identifies the IsReadOnly attribute of a text range.

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 do campo

Exemplos

O exemplo a seguir mostra como obter um valor de atributo para um intervalo de texto no bloco de notas da Microsoft.The following example shows how to obtain an attribute value for a range of text in Microsoft Notepad.

Observação

O bloco de notas da Microsoft é usado como o provedor de texto apenas para fins de exemplo.Microsoft Notepad is used as the text provider for example purposes only. O bloco de notas da Microsoft não é garantido para dar suporte ao valor de atributo que está sendo solicitado.Microsoft Notepad is not guaranteed to support the attribute value being requested.

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

Comentários

Esse atributo representa o estado somente leitura do documento associado ao intervalo de texto de chamada.This attribute represents the read-only state of the document associated with the calling text range.

Observação

Se um documento ou arquivo for somente leitura, mas você ainda puder editá-lo e salvá-lo como outro arquivo, o texto não será considerado somente leitura.If a document or file is read-only, but you can still edit it and save it as another file, the text is not considered read-only.

Esse identificador é usado por aplicativos cliente de automação da interface do usuário.This identifier is used by UI Automation client applications. Os provedores de automação da interface do usuário devem TextPatternIdentifiersusar o campo equivalente no.UI Automation providers should use the equivalent field in TextPatternIdentifiers.

Os clientes de automação da interface do usuário obtêm o GetAttributeValuevalor do atributo chamando.UI Automation clients get the value of the attribute by calling GetAttributeValue.

Os valores para esse atributo são do Booleantipo.Values for this attribute are of type Boolean. O valor padrão é false.The default value is false.

Aplica-se a

Veja também