TextFormatter.FormatMinMaxParagraphWidth Methode

Definition

Gibt einen Wert zurück, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.Returns a value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

Überlädt

FormatMinMaxParagraphWidth(TextSource, Int32, TextParagraphProperties)

Gibt einen Wert zurück, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.Returns a value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

FormatMinMaxParagraphWidth(TextSource, Int32, TextParagraphProperties, TextRunCache)

Gibt einen Wert zurück, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.Returns a value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

FormatMinMaxParagraphWidth(TextSource, Int32, TextParagraphProperties)

Gibt einen Wert zurück, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.Returns a value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

public:
 abstract System::Windows::Media::TextFormatting::MinMaxParagraphWidth FormatMinMaxParagraphWidth(System::Windows::Media::TextFormatting::TextSource ^ textSource, int firstCharIndex, System::Windows::Media::TextFormatting::TextParagraphProperties ^ paragraphProperties);
public abstract System.Windows.Media.TextFormatting.MinMaxParagraphWidth FormatMinMaxParagraphWidth (System.Windows.Media.TextFormatting.TextSource textSource, int firstCharIndex, System.Windows.Media.TextFormatting.TextParagraphProperties paragraphProperties);
abstract member FormatMinMaxParagraphWidth : System.Windows.Media.TextFormatting.TextSource * int * System.Windows.Media.TextFormatting.TextParagraphProperties -> System.Windows.Media.TextFormatting.MinMaxParagraphWidth

Parameter

textSource
TextSource

Ein TextSource-Objekt, das die Textquelle für die Zeile darstellt.A TextSource object that represents the text source for the line.

firstCharIndex
Int32

Ein Int32-Wert, der den Zeichenindex des ersten Zeichens in der Zeile angibt.An Int32 value that specifies the character index of the starting character in the line.

paragraphProperties
TextParagraphProperties

Ein TextParagraphProperties-Objekt, das Absatzeigenschaften, z. B. Flussrichtung, Ausrichtung oder Einzug, darstellt.A TextParagraphProperties object that represents paragraph properties, such as flow direction, alignment, or indentation.

Gibt zurück

Ein MinMaxParagraphWidth-Wert, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.A MinMaxParagraphWidth value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die FormatMinMaxParagraphWidth-Methode verwendet wird, um die minimale Absatz Breite für die formatierten Textzeilen zu generieren.The following example shows how to use the FormatMinMaxParagraphWidth method to generate the minimum paragraph width for the formatted lines of text.

MinMaxParagraphWidth minMaxParaWidth =
    formatter.FormatMinMaxParagraphWidth(customTextSource, 0, customTextParagraphProperties);

// Format each line of text from the text store and draw it.
while (textStorePosition < customTextSource.Text.Length)
{
    // Create a textline from the text store using the TextFormatter object.
    using (TextLine myTextLine = formatter.FormatLine(
        customTextSource,
        textStorePosition,
        minMaxParaWidth.MinWidth,
        customTextParagraphProperties,
        null))
    {
        // Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None);

        // Update the index position in the text store.
        textStorePosition += myTextLine.Length;

        // Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height;
    }
}
Dim minMaxParaWidth As MinMaxParagraphWidth = formatter.FormatMinMaxParagraphWidth(customTextSource, 0, customTextParagraphProperties)

' Format each line of text from the text store and draw it.
Do While textStorePosition < customTextSource.Text.Length
    ' Create a textline from the text store using the TextFormatter object.
    Using myTextLine As TextLine = formatter.FormatLine(customTextSource, textStorePosition, minMaxParaWidth.MinWidth, customTextParagraphProperties, Nothing)
        ' Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None)

        ' Update the index position in the text store.
        textStorePosition += myTextLine.Length

        ' Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height
    End Using
Loop

Hinweise

Im folgenden Text wird die minimale Absatz Breite für den Quelltext verwendet, der als mehrere Zeilen angezeigt wird.The following text uses the minimum paragraph width for the source text, which displays as multiple lines. Die minimale Absatz Breite entspricht dem Wort, das die größte Breite hat, in diesem Fall das Wort "gesprungen".The minimum paragraph width corresponds to the word that has the greatest width - in this case, the word "jumped". Beachten Sie, dass mehrere Wörter in derselben Zeile angezeigt werden können, solange die Gesamtbreite die minimale Absatz Breite nicht überschreitet.Notice that multiple words can appear on the same line, as long as the total width does not exceed the minimum paragraph width.

Textformatierer mit der minimalen Absatz BreiteText Formatter using the minimum paragraph width
Minimale Absatz BreiteMinimum paragraph width

FormatMinMaxParagraphWidth(TextSource, Int32, TextParagraphProperties, TextRunCache)

Gibt einen Wert zurück, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.Returns a value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

public:
 abstract System::Windows::Media::TextFormatting::MinMaxParagraphWidth FormatMinMaxParagraphWidth(System::Windows::Media::TextFormatting::TextSource ^ textSource, int firstCharIndex, System::Windows::Media::TextFormatting::TextParagraphProperties ^ paragraphProperties, System::Windows::Media::TextFormatting::TextRunCache ^ textRunCache);
public abstract System.Windows.Media.TextFormatting.MinMaxParagraphWidth FormatMinMaxParagraphWidth (System.Windows.Media.TextFormatting.TextSource textSource, int firstCharIndex, System.Windows.Media.TextFormatting.TextParagraphProperties paragraphProperties, System.Windows.Media.TextFormatting.TextRunCache textRunCache);
abstract member FormatMinMaxParagraphWidth : System.Windows.Media.TextFormatting.TextSource * int * System.Windows.Media.TextFormatting.TextParagraphProperties * System.Windows.Media.TextFormatting.TextRunCache -> System.Windows.Media.TextFormatting.MinMaxParagraphWidth

Parameter

textSource
TextSource

Ein TextSource-Objekt, das die Textquelle für die Zeile darstellt.A TextSource object that represents the text source for the line.

firstCharIndex
Int32

Ein Int32-Wert, der den Zeichenindex des ersten Zeichens in der Zeile angibt.An Int32 value that specifies the character index of the starting character in the line.

paragraphProperties
TextParagraphProperties

Ein TextParagraphProperties-Objekt, das Absatzeigenschaften, z. B. Flussrichtung, Ausrichtung oder Einzug, darstellt.A TextParagraphProperties object that represents paragraph properties, such as flow direction, alignment, or indentation.

textRunCache
TextRunCache

Ein TextRunCache-Objekt, das den Zwischenspeicherungsmechanismus für das Layout von Text darstellt.A TextRunCache object that represents the caching mechanism for the layout of text.

Gibt zurück

Ein MinMaxParagraphWidth-Wert, der die kleinstmögliche und größtmögliche Absatzbreite darstellt, die den angegebenen Textinhalt vollständig enthalten kann.A MinMaxParagraphWidth value that represents the smallest and largest possible paragraph width that can fully contain the specified text content.

Gilt für: