서식 있는 텍스트 그리기

업데이트: 2007년 11월

이 항목에서는 FormattedText 개체의 기능에 대해 간략하게 설명합니다. 이 개체는 WPF(Windows Presentation Foundation) 응용 프로그램에서 텍스트를 그리기 위한 하위 수준의 제어를 제공합니다.

이 항목에는 다음 단원이 포함되어 있습니다.

• 기술 개요
• FormattedText 개체 사용
• Win32 마이그레이션
• 관련 항목

기술 개요

FormattedText 개체를 사용하면 여러 줄 텍스트를 그릴 수 있으며 각 텍스트 문자의 서식을 개별적으로 지정할 수 있습니다. 다음 예제에서는 여러 서식이 적용된 텍스트를 보여 줍니다.

FormattedText 메서드를 사용하여 표시한 텍스트

서식 있는 텍스트를 사용하는 이유

WPF에는 화면에 텍스트를 그리기 위한 다양한 컨트롤이 포함되어 있습니다. 각 컨트롤은 서로 다른 시나리오에 사용되며 컨트롤마다 고유한 기능 및 제한 사항이 있습니다. UI(사용자 인터페이스)의 간단한 문장과 같이 제한된 텍스트 지원이 필요할 경우 일반적으로 TextBlock 요소를 사용해야 합니다. Label은 최소한의 텍스트 지원만 필요할 경우 사용할 수 있습니다. 자세한 내용은 Windows Presentation Foundation의 문서를 참조하십시오.

FormattedText 개체는 WPF(Windows Presentation Foundation) 텍스트 컨트롤에 비해 훨씬 다양한 텍스트 서식 지정 기능을 제공하며 텍스트를 장식 요소로 사용하려는 경우에 매우 유용합니다. 자세한 내용은 이 항목 아래에 나오는 단원 서식 있는 텍스트를 기하 도형으로 변환을 참조하십시오.

또한 FormattedText 개체는 DrawingVisual에서 파생된 텍스트 기반의 개체를 만들 때도 유용합니다. DrawingVisual은 모양, 이미지 또는 텍스트를 렌더링하는 데 사용되는 간단한 그리기 클래스입니다. 자세한 내용은 DrawingVisual을 사용하여 적중 테스트 샘플을 참조하십시오.

FormattedText 개체 사용

서식 있는 텍스트를 만들려면 FormattedText 생성자를 호출하여 FormattedText 개체를 만듭니다. 초기 서식 있는 텍스트 문자열을 만든 다음에는 다양한 서식 스타일을 적용할 수 있습니다.

MaxTextWidth 속성을 사용하여 텍스트의 너비를 제한하면 지정한 너비를 초과하지 않도록 텍스트가 자동으로 줄 바꿈됩니다. MaxTextHeight 속성을 사용하여 텍스트의 높이를 제한할 수도 있는데 이렇게 하면 지정한 높이를 초과하는 텍스트에 줄임표("…")가 표시됩니다.

자동 줄 바꿈 및 줄임표가 적용된 텍스트

하나 이상의 문자에 여러 서식 스타일을 적용할 수 있습니다. 예를 들어 SetFontSize 및 SetForegroundBrush 메서드를 모두 호출하여 텍스트에 있는 처음 5개 문자의 서식을 변경할 수 있습니다.

다음 코드 예제에서는 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));
}

글꼴 크기의 측정 단위

WPF(Windows Presentation Foundation) 응용 프로그램의 다른 텍스트 개체와 마찬가지로 FormattedText 개체도 장치에 관계없이 픽셀을 측정 단위로 사용합니다. 그러나 대부분의 Win32 응용 프로그램에서는 측정 단위가 포인트입니다. WPF(Windows Presentation Foundation) 응용 프로그램에서 텍스트를 포인트 단위로 표시하려면 장치 독립적 단위(단위당 1/96인치)를 포인트로 변환해야 합니다. 다음 코드 예제에서는 이러한 변환을 수행하는 방법을 보여 줍니다.

// The font size is calculated in terms of points -- not as device-independent pixels.
formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

서식 있는 텍스트를 기하 도형으로 변환

서식 있는 텍스트를 Geometry 개체로 변환하여 시각적으로 흥미로운 다른 유형의 텍스트를 만들 수 있습니다. 예를 들어 텍스트 문자열의 윤곽선을 사용하여 Geometry 개체를 만들 수 있습니다.

선형 그라데이션 브러시를 사용하여 표시한 텍스트 윤곽선

다음 예제에서는 변환된 텍스트의 스트로크, 채우기, 강조 표시를 수정하여 흥미로운 시각 효과를 만드는 여러 가지 방법을 보여 줍니다.

여러 가지 색으로 스트로크와 채우기를 설정하는 예

스트로크에 이미지 브러시가 적용된 예

스트로크 및 강조 표시에 이미지 브러시가 적용된 예

Geometry 개체로 변환된 텍스트는 더 이상 문자 컬렉션이 아니므로 텍스트 문자열의 문자를 수정할 수 없습니다. 그러나 스트로크 및 채우기 속성을 수정하여 변환된 텍스트의 모양을 변경할 수 있습니다. 스트로크는 변환된 텍스트의 윤곽선을 참조하고 채우기는 변환된 텍스트의 윤곽선 내의 영역을 참조합니다. 자세한 내용은 방법: 윤곽선이 있는 텍스트 만들기를 참조하십시오.

서식 있는 텍스트를 PathGeometry 개체로 변환하고 이 개체를 사용하여 텍스트를 강조 표시할 수도 있습니다. 예를 들어 애니메이션이 서식 있는 텍스트의 윤곽선을 따라 표시되도록 PathGeometry 개체에 애니메이션을 적용할 수 있습니다.

다음 예제에서는 PathGeometry 개체로 변환된 서식 있는 텍스트를 보여 줍니다. 애니메이션 타원은 렌더링된 텍스트의 스트로크 경로를 따라 표시됩니다.

텍스트의 기하학적 경로를 따르는 구

자세한 내용은 방법: 텍스트에 대한 PathGeometry 애니메이션 만들기를 참조하십시오.

서식 있는 텍스트를 PathGeometry 개체로 변환하면 텍스트를 다양하게 활용할 수 있습니다. 예를 들면 비디오를 잘라내서 텍스트 안에 표시할 수 있습니다. 자세한 내용은 비디오 텍스트 데모를 참조하십시오.

텍스트의 기하학적 경로를 보여 주는 비디오

Win32 마이그레이션

FormattedText의 텍스트 그리기 기능은 Win32 DrawText 함수의 기능과 유사합니다. 다음 표에는 Win32 API에서 마이그레이션하는 개발자를 위해 Win32 DrawText 플래그와 이에 해당되는 WPF(Windows Presentation Foundation) 항목이 나와 있습니다.

참고 항목

작업

비디오 텍스트 데모

방법: 윤곽선이 있는 텍스트 만들기

개념

Windows Presentation Foundation의 문서

Windows Presentation Foundation의 입력 체계

방법: 텍스트에 대한 PathGeometry 애니메이션 만들기

참조

FormattedText