Auf Englisch lesen

Teilen über


FormattedText.MaxTextWidth Eigenschaft

Definition

Ruft die maximale Textbreite für (Länge) für eine Textzeile ab oder legt diese fest.

C#
public double MaxTextWidth { get; set; }

Eigenschaftswert

Double

Die maximale Textbreite für eine Textzeile, die in geräteunabhängigen Einheiten (1/96. Zoll pro Einheit) bereitgestellt wird.

Beispiele

Im folgenden Beispiel wird ein FormattedText Objekt erstellt und anschließend mehrere Formatierungsformatvorlagen auf den Text angewendet, einschließlich MaxTextWidth.

C#
protected override void OnRender(DrawingContext drawingContext)
{
    string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";

    // Create the initial formatted text string.
    FormattedText formattedText = new FormattedText(
        testString,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface("Verdana"),
        32,
        Brushes.Black);

    // Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300;
    formattedText.MaxTextHeight = 240;

    // Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    // The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

    // Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11);

    // Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(
                            new LinearGradientBrush(
                            Colors.Orange,
                            Colors.Teal,
                            90.0),
                            6, 11);

    // Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28);

    // Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, new Point(10, 0));
}

Hinweise

Text wird umgebrochen, um zu vermeiden, dass der MaxTextWidth Grenzwert überschritten wird.

Glyphenausrichtungsränder müssen innerhalb der Linienanzahlgrenzwerte beibehalten werden. Da viele Schriftarten Glyphen enthalten, die ihre Ausrichtungsränder leicht überhängen, lassen Sie mindestens 1/6 em (Schriftgrad) rand über die angeforderte Zeilenanzahl hinaus, um Platz für solche Überhange zu lassen.

Ein Nullwert für die Zeilenanzahl wird als unendliche Zeilenanzahl behandelt.

Gilt für

Produkt Versionen
.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