C#에서 텍스트 윤곽선 효과를 추가하는 방법

텍스트 스타일링에 TextOutlineEffect를 사용해야 하는 이유는 무엇인가요?

텍스트 윤곽 효과를 적용하려면 TextStyle를 만들고 TextEffect 속성을 TextOutlineEffect로 채우십시오. 그런 다음 Paragraph를 만들고, TextContent이 포함된 Run를 만드세요. TextStyle를 TextContent가 아닌 Run에 할당한 다음, Paragraph에 Run을 추가하려면 AddChild를 사용하십시오. 이는 문서 계층 구조(문서 → 단락 → 실행 → 텍스트 콘텐츠)를 따릅니다.

TextOutlineEffect 클래스는 텍스트 윤곽선의 모든 측면을 제어할 수 있는 포괄적인 API를 제공합니다. 기본 텍스트 서식 옵션과 달리, 선 굵기, 색상, 펜 정렬, 점선 패턴과 같은 윤곽선 속성을 세부적으로 제어할 수 있습니다. 이러한 수준의 제어는 특정 브랜딩 지침이나 접근성 요구 사항을 충족해야 하는 전문 문서를 제작할 때 필수적입니다.

비즈니스 애플리케이션의 경우, 텍스트 윤곽선은 다양한 용지에 인쇄하거나 여러 기기에서 문서를 볼 때 문서의 가독성을 크게 향상시킬 수 있습니다. 윤곽선은 각 문자 주변에 완충 영역을 만들어 복잡한 배경이나 대비가 낮은 상황에서도 텍스트가 읽기 쉽도록 합니다.

윤곽선을 추가하는 기본적인 코드 패턴은 무엇인가요?

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

이 기본 패턴은 텍스트 개요를 적용하는 기본적인 접근 방식을 보여줍니다. 이 코드는 새 문서를 생성하고, 기본 윤곽선 효과가 있는 텍스트 스타일을 정의하고, 해당 스타일을 텍스트에 적용한 다음 결과를 저장합니다. DefaultEffect는 미묘한 너비와 텍스트를 압도하지 않고 향상시키는 보충 색상으로 대부분의 시나리오에 잘 맞는 균형 잡힌 윤곽선을 제공합니다.

윤곽선 모양을 제어하는 ​​속성은 무엇입니까?

텍스트 윤곽선 효과는 모든 디자인 요구 사항에 맞출 수 있도록 다양한 사용자 지정 속성을 제공합니다. 이러한 속성을 이해하면 문서의 시각적 요구 사항과 브랜드 가이드라인에 완벽하게 부합하는 개요를 만들 수 있습니다. 아래는 속성과 그 설명입니다.

각 속성은 전문적인 텍스트 개요를 만드는 데 있어 특정 목적을 수행합니다. 예를 들어, LineWidth는 시각적 중요성에 직접 영향을 미칩니다 – 얇은 윤곽선(0.1-0.3 포인트)은 미묘한 강조를 제공하고, 두꺼운 윤곽선(1.0-2.0 포인트)은 대담한 진술을 만듭니다. Color 속성은 브랜드 일관성을 유지하고 접근성을 위한 충분한 대조를 보장하는 데 중요합니다.

사용자 지정 윤곽선 속성을 적용하는 방법은 무엇입니까?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized text outline"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

이 고급 예제는 사용자 지정 외곽선 구성의 모든 기능을 보여줍니다. 이 코드는 두 줄 스타일의 독특한 빨간색 윤곽선을 생성하여 여러 속성이 함께 작용하여 특정 시각적 효과를 내는 방식을 보여줍니다. 둥근 선 끝과 경사면 연결은 매끄럽고 전문적인 느낌의 윤곽선을 만들어 헤더와 제목에 잘 어울립니다.

실제 운영 환경에서 사용자 지정 레이아웃을 구현할 때는 재사용 가능한 스타일 템플릿을 만드는 것을 고려해 보세요. 문서의 다양한 요소(머리글, 부머리글, 강조 텍스트)에 대한 표준 개요 구성을 정의하고 이를 상수 또는 구성 설정으로 저장합니다. 이러한 접근 방식은 문서 생성 파이프라인 전반에 걸쳐 일관성을 보장하고 브랜드 가이드라인이 변경될 때 유지 관리를 간소화합니다.

최적의 결과를 얻으려면 다양한 출력 형식과 보기 환경에서 개요 효과를 테스트하십시오. 화면에서 보기에 좋아 보여도 인쇄 출력 시에는 조정이 필요할 수 있습니다. 윤곽선 두께와 색상을 선택할 때는 프린터 해상도, 용지 색상, 시청 거리와 같은 요소를 고려해야 합니다. IronWord의 TextOutlineEffect 클래스의 유연성 덕분에 출력 요구 사항에 따라 이러한 매개 변수를 프로그래밍 방식으로 미세 조정할 수 있습니다.