FormattedText 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
WPF(Windows Presentation Foundation) 애플리케이션에서 텍스트를 그리기 위한 수준이 낮은 제어를 제공합니다.
public ref class FormattedTextpublic class FormattedTexttype FormattedText = classPublic Class FormattedText- 상속
-
FormattedText
예제
다음 예제에서는 개체를 FormattedText 만든 다음 텍스트에 여러 서식 스타일을 적용합니다.
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
설명
개체 FormattedText 를 사용하면 텍스트의 각 문자에 개별적으로 서식을 지정할 수 있는 여러 줄 텍스트를 그릴 수 있습니다. 다음 예에서는 여러 서식이 적용된 텍스트를 보여줍니다.
서식이 지정된 텍스트 문자열의 예
WPF FormattedText 의 텍스트 기능 측면에서 텍스트를 그래픽 요소로 처리하므로 "하위 수준"으로 간주됩니다. WPF에서 텍스트의 다른 측면은 텍스트 전용 컨트롤의 컨텍스트에서 텍스트를 처리(TextBlock, TextBox흐름 문서 모델 구현(Flow 문서 개요 참조) 또는 XPS 문서 모델 지원(WPF의 문서 참조).
대부분의 setter 메서드 FormattedText 는 지원 TextElement되는 연결된 속성과 유사하지만 TextElement 연결된 속성은 흐름 또는 XPS에 대한 상위 수준 텍스트 지원에 적용됩니다.
생성자
속성
| Baseline |
FormattedText 개체의 첫 줄 맨 위에서 첫 줄 기준선까지의 거리를 가져옵니다. |
| Extent |
첫 줄 맨 위에 그려진 픽셀에서 마지막 줄 맨 아래에 그려진 픽셀까지의 거리를 가져옵니다. |
| FlowDirection |
FlowDirection 개체의 FormattedText을 가져오거나 설정합니다. |
| Height |
FormattedText 개체의 첫 줄 맨 위에서 마지막 줄 맨 아래까지의 거리를 가져옵니다. |
| LineHeight |
줄 높이 또는 텍스트 줄 간의 줄 간격을 가져옵니다. |
| MaxLineCount |
표시할 최대 줄 수를 가져오거나 설정합니다. MaxLineCount를 초과하는 텍스트는 표시되지 않습니다. |
| MaxTextHeight |
텍스트 열의 최대 높이를 가져오거나 설정합니다. |
| MaxTextWidth |
텍스트 줄에 대한 최대 텍스트 너비(길이)를 가져오거나 설정합니다. |
| MinWidth |
지정한 텍스트 내용 전체를 포함할 수 있는 최소 텍스트 너비를 가져옵니다. |
| OverhangAfter |
마지막 텍스트 줄의 아래에서 맨 아래에 그려진 픽셀까지의 거리를 가져옵니다. |
| OverhangLeading |
선행 맞춤 지점에서 줄 맨 앞에 그려진 픽셀까지의 최대 거리를 가져옵니다. |
| OverhangTrailing |
잉크가 지정된 맨 뒤의 픽셀에서 줄의 후행 맞춤 지점까지의 최대 거리를 가져옵니다. |
| PixelsPerDip |
텍스트가 렌더링되어야 하는 PixelsPerDip를 가져오거나 설정합니다. |
| Text |
표시할 텍스트 문자열을 가져옵니다. |
| TextAlignment |
FormattedText 개체 내의 텍스트 맞춤을 가져오거나 설정합니다. |
| Trimming |
텍스트 생략을 나타내는 방법을 가져오거나 설정합니다. |
| Width |
후행 공백 문자를 제외한 줄의 선행 맞춤 지점과 후행 맞춤 지점 간의 너비를 가져옵니다. |
| WidthIncludingTrailingWhitespace |
후행 공백 문자를 포함한 줄의 선행 맞춤 지점과 후행 맞춤 지점 간의 너비를 가져옵니다. |