TextPattern.CultureAttribute 欄位

定義

命名空間:

System.Windows.Automation

組件:

UIAutomationClient.dll

識別文字範圍的 Culture (CultureInfo) 屬性，細分到附屬語言層級，例如瑞士法文 (fr-CH) 而非法文 (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 

欄位值

AutomationTextAttribute

範例

下列範例示範如何取得 Microsoft 記事本中文字範圍的屬性值。

注意

Microsoft 記事本僅做為文字提供者。 Microsoft 記事本不保證支援所要求的屬性值。

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

備註

消費者介面自動化用戶端應用程式會使用此識別碼。 消費者介面自動化提供者應該使用 中的 TextPatternIdentifiers 對等欄位。

消費者介面自動化用戶端藉由呼叫 GetAttributeValue 取得 屬性的值。

此屬性的值的類型為 CultureInfo 。 預設值是應用程式使用者介面的語言。

如需語言程式碼格式的詳細資訊，請參閱 CultureInfo 。

注意

在某些情況下，伺服器不支援語言標籤，或作者無法使用它。 在這些情況下，會套用預設值。

另請參閱

• TextPatternRange