TextPattern.CultureAttribute Champ
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.AutomationTextAttributePublic Shared ReadOnly CultureAttribute As AutomationTextAttribute L’exemple suivant montre comment obtenir une valeur d’attribut pour une plage de texte dans Microsoft Bloc-notes.
Remarque
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
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.
Remarque
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.
| Produit | Versions |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |