TextFormatter.FormatLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает текстовую строку TextLine, используемую для форматирования и отображения содержимого документа.
Перегрузки
FormatLine(TextSource, Int32, Double, TextParagraphProperties, TextLineBreak) |
Создает текстовую строку TextLine, используемую для форматирования и отображения содержимого документа. |
FormatLine(TextSource, Int32, Double, TextParagraphProperties, TextLineBreak, TextRunCache) |
Создает текстовую строку TextLine, используемую для форматирования и отображения содержимого документа. |
FormatLine(TextSource, Int32, Double, TextParagraphProperties, TextLineBreak)
Создает текстовую строку TextLine, используемую для форматирования и отображения содержимого документа.
public:
abstract System::Windows::Media::TextFormatting::TextLine ^ FormatLine(System::Windows::Media::TextFormatting::TextSource ^ textSource, int firstCharIndex, double paragraphWidth, System::Windows::Media::TextFormatting::TextParagraphProperties ^ paragraphProperties, System::Windows::Media::TextFormatting::TextLineBreak ^ previousLineBreak);
public abstract System.Windows.Media.TextFormatting.TextLine FormatLine (System.Windows.Media.TextFormatting.TextSource textSource, int firstCharIndex, double paragraphWidth, System.Windows.Media.TextFormatting.TextParagraphProperties paragraphProperties, System.Windows.Media.TextFormatting.TextLineBreak previousLineBreak);
abstract member FormatLine : System.Windows.Media.TextFormatting.TextSource * int * double * System.Windows.Media.TextFormatting.TextParagraphProperties * System.Windows.Media.TextFormatting.TextLineBreak -> System.Windows.Media.TextFormatting.TextLine
Public MustOverride Function FormatLine (textSource As TextSource, firstCharIndex As Integer, paragraphWidth As Double, paragraphProperties As TextParagraphProperties, previousLineBreak As TextLineBreak) As TextLine
Параметры
- textSource
- TextSource
Значение TextSource, представляющее источник текста для строки.
- paragraphWidth
- Double
Значение типа Double, которое определяет ширину абзаца, который заполняет строка.
- paragraphProperties
- TextParagraphProperties
Значение типа TextParagraphProperties, которое представляет свойства параграфа, такие как направление текста, выравнивание или отступы.
- previousLineBreak
- TextLineBreak
Значение TextLineBreak, определяющее состояние средства форматирования текста, то есть позицию предыдущего разрыва строки в абзаце процессом форматирования текста.
Возвращаемое значение
Значение типа TextLine, представляющее строку текста, которую можно отобразить.
Примеры
В следующем примере показано, как использовать FormatLine метод для возврата отформатированного TextLine.
// Create a textline from the text store using the TextFormatter object.
TextLine myTextLine = formatter.FormatLine(
customTextSource,
0,
400,
customTextParagraphProperties,
null);
// Draw the formatted text into the drawing context.
myTextLine.Draw(drawingContext, new Point(0, 0), InvertAxes.None);
' Create a textline from the text store using the TextFormatter object.
Dim myTextLine As TextLine = formatter.FormatLine(customTextSource, 0, 400, customTextParagraphProperties, Nothing)
' Draw the formatted text into the drawing context.
myTextLine.Draw(drawingContext, New Point(0, 0), InvertAxes.None)
Применяется к
FormatLine(TextSource, Int32, Double, TextParagraphProperties, TextLineBreak, TextRunCache)
Создает текстовую строку TextLine, используемую для форматирования и отображения содержимого документа.
public:
abstract System::Windows::Media::TextFormatting::TextLine ^ FormatLine(System::Windows::Media::TextFormatting::TextSource ^ textSource, int firstCharIndex, double paragraphWidth, System::Windows::Media::TextFormatting::TextParagraphProperties ^ paragraphProperties, System::Windows::Media::TextFormatting::TextLineBreak ^ previousLineBreak, System::Windows::Media::TextFormatting::TextRunCache ^ textRunCache);
public abstract System.Windows.Media.TextFormatting.TextLine FormatLine (System.Windows.Media.TextFormatting.TextSource textSource, int firstCharIndex, double paragraphWidth, System.Windows.Media.TextFormatting.TextParagraphProperties paragraphProperties, System.Windows.Media.TextFormatting.TextLineBreak previousLineBreak, System.Windows.Media.TextFormatting.TextRunCache textRunCache);
abstract member FormatLine : System.Windows.Media.TextFormatting.TextSource * int * double * System.Windows.Media.TextFormatting.TextParagraphProperties * System.Windows.Media.TextFormatting.TextLineBreak * System.Windows.Media.TextFormatting.TextRunCache -> System.Windows.Media.TextFormatting.TextLine
Public MustOverride Function FormatLine (textSource As TextSource, firstCharIndex As Integer, paragraphWidth As Double, paragraphProperties As TextParagraphProperties, previousLineBreak As TextLineBreak, textRunCache As TextRunCache) As TextLine
Параметры
- textSource
- TextSource
Объект TextSource, представляющий источник текста для строки.
- paragraphWidth
- Double
Значение типа Double, которое определяет ширину абзаца, который заполняет строка.
- paragraphProperties
- TextParagraphProperties
Объект TextParagraphProperties, который представляет свойства абзаца, такие как направление текста, выравнивание или отступы.
- previousLineBreak
- TextLineBreak
Объект TextLineBreak, определяющий состояние средства форматирования текста как позицию предыдущего разрыва строки в абзаце процессом форматирования текста.
- textRunCache
- TextRunCache
Объект TextRunCache, представляющий механизм кэширования для макета текста.
Возвращаемое значение
Значение типа TextLine, представляющее строку текста, которую можно отобразить.
Комментарии
Этот метод используется для повышения производительности в приложениях, в которых TextLine существенно влияет на производительность.