TextPattern.CultureAttribute Campo

Definição

Identifica o atributo Culture (CultureInfo) de um intervalo de texto até o nível de subidioma; por exemplo, francês-Suíça (fr-CH) em vez de francês (fr).Identifies the Culture (CultureInfo) attribute of a text range down to the sub-language level; for example, French-Switzerland (fr-CH) instead of French (fr).

public: static initonly System::Windows::Automation::AutomationTextAttribute ^ CultureAttribute;
public static readonly System.Windows.Automation.AutomationTextAttribute CultureAttribute;
 staticval mutable CultureAttribute : System.Windows.Automation.AutomationTextAttribute
Public Shared ReadOnly CultureAttribute 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 GetCultureAttribute()
{
    // 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.CultureAttribute);
    if (oAttribute == TextPattern.MixedAttributeValue)
    {
        Console.WriteLine("Mixed culture info.");
    }
    else
    {
        Console.WriteLine(oAttribute.ToString());
    }
}
Private Sub GetCultureAttribute()
    ' 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.CultureAttribute)
    If (oAttribute = TextPattern.MixedAttributeValue) Then
        Console.WriteLine("Mixed culture info.")
    Else
        Console.WriteLine(oAttribute.ToString())
    End If
End Sub

Comentários

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 CultureInfotipo.Values for this attribute are of type CultureInfo. O valor padrão é o idioma da interface do usuário do aplicativo.The default value is the language of the application user interface.

Consulte CultureInfo para obter mais detalhes sobre o formato de código de idioma.See CultureInfo for more detail on the language code format.

Observação

Pode haver casos em que o servidor não dá suporte à marca de idioma ou os autores não podem usá-la.There might be cases where the server does not support the language tag or authors cannot use it. Nesses casos, o padrão se aplica.In those cases the default applies.

Aplica-se a

Veja também