FormattedText FormattedText FormattedText FormattedText Class

정의

WPF(Windows Presentation Foundation) 애플리케이션에서 텍스트를 그리기 위한 수준이 낮은 제어를 제공합니다.Provides low-level control for drawing text in Windows Presentation Foundation (WPF) applications.

public ref class FormattedText
public class FormattedText
type FormattedText = class
Public Class FormattedText
상속
FormattedTextFormattedTextFormattedTextFormattedText

예제

다음 예제에서는 FormattedText 개체를 텍스트에 여러 서식 지정 스타일을 적용 합니다.The following example creates a FormattedText object and then applies several formatting styles to the text.

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 개체는 각 문자를 텍스트에 서식을 지정할 수 개별적으로 여러 줄 텍스트를 그릴 수 있습니다.The FormattedText object allows you to draw multi-line text, in which each character in the text can be individually formatted. 다음 예에서는 여러 서식이 적용된 텍스트를 보여줍니다.The following example shows text that has several formats applied to it.

FormattedText 개체를 사용 하 여 표시 되는 텍스트Text displayed using FormattedText object
서식 있는 텍스트 문자열의 예Example of a formatted text string

텍스트 기능 측면 WPFWPF, FormattedText 그래픽 요소로 텍스트를 처리 하기 때문에 "하위 수준"으로 간주 됩니다.In terms of text features in WPFWPF, FormattedText is considered "low-level" because it processes text as graphical elements. 텍스트의 다른 측면 WPFWPF 컨텍스트에서 텍스트 전용 컨트롤의 텍스트를 처리 (TextBlock, TextBox), 흐름 문서 모델을 구현 (참조 유동 문서 개요)를 지원 합니다 XPSXPS 모델 문서화 (참조 WPF의 문서).Other aspects of text in WPFWPF handle text in the context of controls that are dedicated to text (TextBlock, TextBox), implement the flow document model (see Flow Document Overview), or support the XPSXPS document model (see Documents in WPF).

setter 메서드 중 많은 FormattedText 에서 지원 되는 연결 된 속성의 유사성 TextElement, 되지만 TextElement 상위 텍스트에 적용 되는 연결 된 속성 flow에 대 한 지원 또는 XPSXPS합니다.Many of the setter methods in FormattedText have similarities to attached properties that are supported by TextElement, but the TextElement attached properties apply to the higher-level text support either for flow or XPSXPS.

생성자

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)

지정한 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기 및 브러시를 사용하여 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, and brush.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)

지정된 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기, 전경 브러시 및 pixelsPerDip 값으로 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, and pixelsPerDip value.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)

지정한 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기, 브러시 및 숫자 대체 동작을 사용하여 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, brush, and number substitution behavior.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double)

지정된 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기, 브러시 숫자 대체 동작, pixelsPerDip 값을 사용하여 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, number substitution behavior, and pixelsPerDip value.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)

지정한 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기, 브러시, 숫자 대체 동작 및 텍스트 서식 모드를 사용하여 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, brush, number substitution behavior, and text formatting mode.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double) FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double)

지정된 텍스트, 문화권, 흐름 방향, 서체, 글꼴 크기, 브러시 숫자 대체 동작, pixelsPerDip 값을 사용하여 FormattedText 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, number substitution behavior, and pixelsPerDip value.

속성

Baseline Baseline Baseline Baseline

FormattedText 개체의 첫 줄 맨 위에서 첫 줄 기준선까지의 거리를 가져옵니다.Gets the distance from the top of the first line to the baseline of the first line of a FormattedText object.

Extent Extent Extent Extent

첫 줄 맨 위에 그려진 픽셀에서 마지막 줄 맨 아래에 그려진 픽셀까지의 거리를 가져옵니다.Gets the distance from the topmost drawn pixel of the first line to the bottommost drawn pixel of the last line.

FlowDirection FlowDirection FlowDirection FlowDirection

FlowDirection 개체의 FormattedText을 가져오거나 설정합니다.Gets or sets the FlowDirection of a FormattedText object.

Height Height Height Height

FormattedText 개체의 첫 줄 맨 위에서 마지막 줄 맨 아래까지의 거리를 가져옵니다.Gets the distance from the top of the first line to the bottom of the last line of the FormattedText object.

LineHeight LineHeight LineHeight LineHeight

줄 높이 또는 텍스트 줄 간의 줄 간격을 가져옵니다.Gets the line height, or line spacing, between lines of text.

MaxLineCount MaxLineCount MaxLineCount MaxLineCount

표시할 최대 줄 수를 가져오거나 설정합니다.Gets or sets the maximum number of lines to display. MaxLineCount를 초과하는 텍스트는 표시되지 않습니다.Text exceeding the MaxLineCount will not be displayed.

MaxTextHeight MaxTextHeight MaxTextHeight MaxTextHeight

텍스트 열의 최대 높이를 가져오거나 설정합니다.Gets or sets the maximum height of a text column.

MaxTextWidth MaxTextWidth MaxTextWidth MaxTextWidth

텍스트 줄에 대한 최대 텍스트 너비(길이)를 가져오거나 설정합니다.Gets or sets the maximum text width (length) for a line of text.

MinWidth MinWidth MinWidth MinWidth

지정한 텍스트 내용 전체를 포함할 수 있는 최소 텍스트 너비를 가져옵니다.Gets the smallest possible text width that can fully contain the specified text content.

OverhangAfter OverhangAfter OverhangAfter OverhangAfter

마지막 텍스트 줄의 아래에서 맨 아래에 그려진 픽셀까지의 거리를 가져옵니다.Gets the distance from the bottom of the last line of text to the bottommost drawn pixel.

OverhangLeading OverhangLeading OverhangLeading OverhangLeading

선행 맞춤 지점에서 줄 맨 앞에 그려진 픽셀까지의 최대 거리를 가져옵니다.Gets the maximum distance from the leading alignment point to the leading drawn pixel of a line.

OverhangTrailing OverhangTrailing OverhangTrailing OverhangTrailing

잉크가 지정된 맨 뒤의 픽셀에서 줄의 후행 맞춤 지점까지의 최대 거리를 가져옵니다.Gets the maximum distance from the trailing inked pixel to the trailing alignment point of a line.

PixelsPerDip PixelsPerDip PixelsPerDip PixelsPerDip

텍스트가 렌더링되어야 하는 PixelsPerDip를 가져오거나 설정합니다.Get or sets the PixelsPerDip at which the text should be rendered.

Text Text Text Text

표시할 텍스트 문자열을 가져옵니다.Gets the string of text to be displayed.

TextAlignment TextAlignment TextAlignment TextAlignment

FormattedText 개체 내의 텍스트 맞춤을 가져오거나 설정합니다.Gets or sets the alignment of text within a FormattedText object.

Trimming Trimming Trimming Trimming

텍스트 생략을 나타내는 방법을 가져오거나 설정합니다.Gets or sets the means by which the omission of text is indicated.

Width Width Width Width

후행 공백 문자를 제외한 줄의 선행 맞춤 지점과 후행 맞춤 지점 간의 너비를 가져옵니다.Gets the width between the leading and trailing alignment points of a line, excluding any trailing white-space characters.

WidthIncludingTrailingWhitespace WidthIncludingTrailingWhitespace WidthIncludingTrailingWhitespace WidthIncludingTrailingWhitespace

후행 공백 문자를 포함한 줄의 선행 맞춤 지점과 후행 맞춤 지점 간의 너비를 가져옵니다.Gets the width between the leading and trailing alignment points of a line, including any trailing white-space characters.

메서드

BuildGeometry(Point) BuildGeometry(Point) BuildGeometry(Point) BuildGeometry(Point)

모든 문자 모양과 텍스트 장식을 포함하여 서식 있는 텍스트를 나타내는 Geometry 개체를 반환합니다.Returns a Geometry object that represents the formatted text, including all glyphs and text decorations.

BuildHighlightGeometry(Point) BuildHighlightGeometry(Point) BuildHighlightGeometry(Point) BuildHighlightGeometry(Point)

서식 있는 텍스트의 강조 표시 경계 상자를 나타내는 Geometry 개체를 반환합니다.Returns a Geometry object that represents the highlight bounding box of the formatted text.

BuildHighlightGeometry(Point, Int32, Int32) BuildHighlightGeometry(Point, Int32, Int32) BuildHighlightGeometry(Point, Int32, Int32) BuildHighlightGeometry(Point, Int32, Int32)

서식 있는 텍스트의 지정한 부분 문자열에 대한 강조 표시 경계 상자를 나타내는 Geometry 개체를 반환합니다.Returns a Geometry object that represents the highlight bounding box for a specified substring of the formatted text.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetMaxTextWidths() GetMaxTextWidths() GetMaxTextWidths() GetMaxTextWidths()

텍스트 너비의 배열을 검색합니다.Retrieves an array of text widths. 배열의 각 요소는 순차적 텍스트 줄의 최대 텍스트 너비를 나타냅니다.Each element in the array represents the maximum text width of sequential lines of text.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
SetCulture(CultureInfo) SetCulture(CultureInfo) SetCulture(CultureInfo) SetCulture(CultureInfo)

CultureInfo 개체의 전체 문자 집합에 대한 FormattedText를 설정합니다.Sets the CultureInfo for the entire set of characters in the FormattedText object.

SetCulture(CultureInfo, Int32, Int32) SetCulture(CultureInfo, Int32, Int32) SetCulture(CultureInfo, Int32, Int32) SetCulture(CultureInfo, Int32, Int32)

CultureInfo 개체의 지정한 하위 문자 집합에 대한 FormattedText를 설정합니다.Sets the CultureInfo for a specified subset of characters in the FormattedText object.

SetFontFamily(FontFamily) SetFontFamily(FontFamily) SetFontFamily(FontFamily) SetFontFamily(FontFamily)

FormattedText 개체에 대한 글꼴 패밀리를 설정합니다.Sets the font family for a FormattedText object.

SetFontFamily(FontFamily, Int32, Int32) SetFontFamily(FontFamily, Int32, Int32) SetFontFamily(FontFamily, Int32, Int32) SetFontFamily(FontFamily, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 패밀리를 설정합니다.Sets the font family for a specified subset of characters in the FormattedText object.

SetFontFamily(String) SetFontFamily(String) SetFontFamily(String) SetFontFamily(String)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 패밀리를 설정합니다.Sets the font family for the entire set of characters in the FormattedText object.

SetFontFamily(String, Int32, Int32) SetFontFamily(String, Int32, Int32) SetFontFamily(String, Int32, Int32) SetFontFamily(String, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 패밀리를 설정합니다.Sets the font family for a specified subset of characters in the FormattedText object.

SetFontSize(Double) SetFontSize(Double) SetFontSize(Double) SetFontSize(Double)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 크기를 설정합니다.Sets the font size for the entire set of characters in the FormattedText object.

SetFontSize(Double, Int32, Int32) SetFontSize(Double, Int32, Int32) SetFontSize(Double, Int32, Int32) SetFontSize(Double, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 크기를 설정합니다.Sets the font size for a specified subset of characters in the FormattedText object.

SetFontStretch(FontStretch) SetFontStretch(FontStretch) SetFontStretch(FontStretch) SetFontStretch(FontStretch)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 늘이기 값을 설정합니다.Sets the font stretch value for the entire set of characters in the FormattedText object.

SetFontStretch(FontStretch, Int32, Int32) SetFontStretch(FontStretch, Int32, Int32) SetFontStretch(FontStretch, Int32, Int32) SetFontStretch(FontStretch, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 늘이기 값을 설정합니다.Sets the font stretch value for a specified subset of characters in the FormattedText object.

SetFontStyle(FontStyle) SetFontStyle(FontStyle) SetFontStyle(FontStyle) SetFontStyle(FontStyle)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 스타일을 설정합니다.Sets the font style for the entire set of characters in the FormattedText object.

SetFontStyle(FontStyle, Int32, Int32) SetFontStyle(FontStyle, Int32, Int32) SetFontStyle(FontStyle, Int32, Int32) SetFontStyle(FontStyle, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 스타일을 설정합니다.Sets the font style for a specified subset of characters in the FormattedText object.

SetFontTypeface(Typeface) SetFontTypeface(Typeface) SetFontTypeface(Typeface) SetFontTypeface(Typeface)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 서체를 설정합니다.Sets the font typeface for the entire set of characters in the FormattedText object.

SetFontTypeface(Typeface, Int32, Int32) SetFontTypeface(Typeface, Int32, Int32) SetFontTypeface(Typeface, Int32, Int32) SetFontTypeface(Typeface, Int32, Int32)

FormattedText 개체의 지정한 하위 문자 집합에 대한 글꼴 서체를 설정합니다.Sets the font typeface for a specified subset of characters in the FormattedText object.

SetFontWeight(FontWeight) SetFontWeight(FontWeight) SetFontWeight(FontWeight) SetFontWeight(FontWeight)

FormattedText 개체의 전체 문자 집합에 대한 글꼴 두께를 설정합니다.Sets the font weight for the entire set of characters in the FormattedText object.

SetFontWeight(FontWeight, Int32, Int32) SetFontWeight(FontWeight, Int32, Int32) SetFontWeight(FontWeight, Int32, Int32) SetFontWeight(FontWeight, Int32, Int32)

FontWeight 개체 내의 지정한 텍스트에 대한 FormattedText를 변경합니다.Changes the FontWeight for specified text within a FormattedText object.

SetForegroundBrush(Brush) SetForegroundBrush(Brush) SetForegroundBrush(Brush) SetForegroundBrush(Brush)

전체 Brush 개체에 대한 전경 FormattedText를 변경합니다.Changes the foreground Brush for an entire FormattedText object.

SetForegroundBrush(Brush, Int32, Int32) SetForegroundBrush(Brush, Int32, Int32) SetForegroundBrush(Brush, Int32, Int32) SetForegroundBrush(Brush, Int32, Int32)

Brush 개체 내의 지정한 텍스트에 대한 전경 FormattedText를 변경합니다.Changes the foreground Brush for specified text within a FormattedText object.

SetMaxTextWidths(Double[]) SetMaxTextWidths(Double[]) SetMaxTextWidths(Double[]) SetMaxTextWidths(Double[])

줄 단위로 FormattedText 내의 최대 텍스트 너비 배열을 설정합니다.Sets an array of maximum text widths within the FormattedText, on a per-line basis. 배열의 각 요소는 순차적 텍스트 줄의 최대 텍스트 너비를 나타냅니다.Each element in the array represents the maximum text width of sequential lines of text.

SetNumberSubstitution(NumberSubstitution) SetNumberSubstitution(NumberSubstitution) SetNumberSubstitution(NumberSubstitution) SetNumberSubstitution(NumberSubstitution)

FormattedText 개체의 전체 문자 집합에 대한 숫자 대체 동작을 설정합니다.Sets the number substitution behavior for the entire set of characters in the FormattedText object.

SetNumberSubstitution(NumberSubstitution, Int32, Int32) SetNumberSubstitution(NumberSubstitution, Int32, Int32) SetNumberSubstitution(NumberSubstitution, Int32, Int32) SetNumberSubstitution(NumberSubstitution, Int32, Int32)

FormattedText 개체 내의 지정한 텍스트에 대한 숫자 대체 동작을 설정합니다.Sets the number substitution behavior for specified text within a FormattedText object.

SetTextDecorations(TextDecorationCollection) SetTextDecorations(TextDecorationCollection) SetTextDecorations(TextDecorationCollection) SetTextDecorations(TextDecorationCollection)

TextDecorationCollection 개체의 전체 문자 집합에 대한 FormattedText를 설정합니다.Sets the TextDecorationCollection for the entire set of characters in the FormattedText object.

SetTextDecorations(TextDecorationCollection, Int32, Int32) SetTextDecorations(TextDecorationCollection, Int32, Int32) SetTextDecorations(TextDecorationCollection, Int32, Int32) SetTextDecorations(TextDecorationCollection, Int32, Int32)

TextDecorationCollection 개체 내의 지정한 텍스트에 대한 FormattedText을 설정합니다.Sets the TextDecorationCollection for specified text within a FormattedText object.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보