FormattedText.MaxTextWidth Propriété

Définition

Obtient ou définit la largeur maximum de texte (longueur) pour une ligne de texte.Gets or sets the maximum text width (length) for a line of text.

public:
 property double MaxTextWidth { double get(); void set(double value); };
public double MaxTextWidth { get; set; }
member this.MaxTextWidth : double with get, set
Public Property MaxTextWidth As Double

Valeur de propriété

Double

Largeur maximale du texte d’une ligne de texte, fournie en unités indépendantes du périphérique (1/96ème de pouce par unité).The maximum text width for a line of text, provided in device-independent units (1/96th inch per unit).

Exemples

L’exemple suivant crée un FormattedText objet, puis applique plusieurs styles de mise en forme au texte, y compris MaxTextWidth .The following example creates a FormattedText object and then applies several formatting styles to the text, including MaxTextWidth.

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));
}
Protected Overrides Sub OnRender(ByVal drawingContext As DrawingContext)
    Dim testString As String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor"

    ' Create the initial formatted text string.
    Dim formattedText As 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))
End Sub

Remarques

Le texte sera renvoyé à la ligne pour éviter de dépasser la MaxTextWidth limite.Text will wrap to avoid exceeding the MaxTextWidth limit.

Les bords d’alignement des glyphes doivent être conservés dans les limites du nombre de lignes.Glyph alignment edges must be kept within the line count limits. Étant donné que de nombreuses polices contiennent des glyphes qui dépassent légèrement leurs bords d’alignement, autorisez au moins la marge de 1/6 em (taille de police) au-delà du nombre de lignes demandé, afin de laisser de la place pour de telles surblocages.Because many fonts contain glyphs that slightly overhang their alignment edges, allow at least 1/6 em (font size) margin beyond the line count requested, to leave room for such overhangs.

Une valeur zéro pour le nombre de lignes est traitée comme un nombre de lignes infini.A zero value for line count is treated as an infinite line count.

S’applique à