TextPattern.FontNameAttribute Feld

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Bezeichnet das FontName-Attribut eines Textbereichs.

C#

public static readonly System.Windows.Automation.AutomationTextAttribute FontNameAttribute;

Feldwert

AutomationTextAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Attributwert für einen Textbereich in Microsoft Editor abrufen.

Hinweis

Microsoft Editor wird nur als Textanbieter verwendet. Microsoft Editor ist nicht garantiert, den angeforderten Attributwert zu unterstützen.

C#

/// -------------------------------------------------------------------
/// <summary>
/// Outputs the FontNameAttribute value for a range of text.
/// </summary>
/// <param name="targetTextElement">
/// The AutomationElment that represents a text control.
/// </param>
/// -------------------------------------------------------------------
private void GetFontNameAttribute(AutomationElement targetTextElement)
{
    TextPattern textPattern = 
        targetTextElement.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

    if (textPattern == null)
    {
        // Target control doesn't support TextPattern.
        return;
    }

    // If the target control doesn't support selection then return.
    // Otherwise, get the text attribute for the selected text.
    // If there are currently no selections then the text attribute 
    // will be obtained from the insertion point.
    TextPatternRange[] textRanges;
    if (textPattern.SupportedTextSelection == SupportedTextSelection.None)
    {
        return;
    }
    else
    {
        textRanges = textPattern.GetSelection();
    }

    foreach (TextPatternRange textRange in textRanges)
    {
        Object textAttribute =
            textRange.GetAttributeValue(
            TextPattern.FontNameAttribute);

        if (textAttribute == TextPattern.MixedAttributeValue)
        {
            // Returns MixedAttributeValue if the value of the 
            // specified attribute varies over the text range. 
            Console.WriteLine("Mixed fonts.");
        }
        else if (textAttribute == AutomationElement.NotSupported)
        {
            // Returns NotSupported if the specified attribute is 
            // not supported by the provider or the control. 
            Console.WriteLine(
                "FontNameAttribute not supported by provider.");
        }
        else
        {
            Console.WriteLine(textAttribute.ToString());
        }
    }
}

Hinweise

Beispielwerte für dieses Attribut umfassen "Arial Black" und "Arial Narrow".

Die Werte für dieses Attribut sind nicht lokalisiert.

Dieser Bezeichner wird von Benutzeroberflächenautomatisierung Clientanwendungen verwendet. Benutzeroberflächenautomatisierung Anbieter sollten das entsprechende Feld in TextPatternIdentifiers.

Benutzeroberflächenautomatisierung Clients erhalten den Wert des Attributs durch Aufrufen GetAttributeValue.

Werte für dieses Attribut sind vom Typ String. Der Standardwert ist ein empty string.

Gilt für

Siehe auch

• TextPatternRange
• FontFamily