TextPattern.CultureAttribute Champ

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Identifie l’attribut Culture (CultureInfo) d’une plage de texte au niveau de la sous-langue ; par exemple, le Français-Suisse (fr-CH) à la place du Français (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 

Valeur de champ

AutomationTextAttribute

Exemples

L’exemple suivant montre comment obtenir une valeur d’attribut pour une plage de texte dans Microsoft Bloc-notes.

Notes

Microsoft Bloc-notes est utilisé comme fournisseur de texte à des fins d’exemple uniquement. Microsoft Bloc-notes n’est pas garanti pour prendre en charge la valeur d’attribut demandée.

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

Remarques

Cet identificateur est utilisé par UI Automation applications clientes. UI Automation fournisseurs doivent utiliser le champ équivalent dans TextPatternIdentifiers.

UI Automation clients obtiennent la valeur de l’attribut en appelant GetAttributeValue.

Les valeurs de cet attribut sont de type CultureInfo. La valeur par défaut est la langue de l’interface utilisateur de l’application.

Pour plus d’informations sur le format de code de langue, voir CultureInfo plus en détail.

Notes

Il peut y avoir des cas où le serveur ne prend pas en charge la balise de langue ou les auteurs ne peuvent pas l’utiliser. Dans ces cas, la valeur par défaut s’applique.

Voir aussi

• TextPatternRange