C#에서 텍스트에 그림자 효과를 추가하는 방법 | IronWord

C#에서 텍스트에 그림자 효과를 추가하는 방법

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord를 사용하여 C#에서 텍스트에 그림자 효과를 추가하려면 TextStyle 객체를 만들어 ShadowEffect 속성을 설정한 후, OuterShadow1 같은 미리 설정된 그림자를 적용하거나 흐림, 거리 및 색상과 같은 속성을 사용자 정의하여 전문적인 텍스트 깊이를 연출합니다.

텍스트에 그림자 효과를 적용하는 것은 텍스트 요소에 깊이감과 뚜렷한 대비를 부여하기 위해 사용되는 시각적 향상 기법입니다. 이 기능을 적용하면 원본 텍스트 뒤에 원본 텍스트의 복제본이 약간 어긋나게 배치되어 그림자 효과를 줍니다. 그림자라고도 하는 이 보조 텍스트는 다양한 시각적 효과를 내기 위해 여러 가지 방법으로 조정할 수 있습니다.

그림자 효과는 텍스트를 강조해야 하는 전문 문서, 프레젠테이션 및 보고서를 제작할 때 특히 유용합니다. 파워포인트에서 빈 프레젠테이션을 만드는 것과 유사하게, IronWord 사용하면 워드 문서에 정교한 텍스트 효과를 적용하여 프로그래밍 방식으로 문서를 향상시킬 수 있습니다. 이 라이브러리는 빠른 구현을 위한 사전 설정된 그림자 옵션과 고유한 브랜딩 요구 사항을 충족하는 광범위한 사용자 지정 기능을 모두 제공합니다.

빠른 시작: 한 줄로 사전 설정 그림자 효과 추가

IronWord 사용하여 Word 문서의 텍스트에 그림자를 추가하는 방법은 다음과 같습니다. 스타일과 그림자를 정의하는 데 단 한 줄만 필요하며, 저장만 하면 됩니다. 최소한의 설정으로 빠르게 구현할 수 있습니다. 그림자 효과를 구현하기 전에, 실제 문서에 워터마크가 표시되지 않도록 라이선스 키를 올바르게 구성했는지 확인하십시오.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronWord 설치하기

    PM > Install-Package IronWord
  2. 다음 코드 조각을 복사하여 실행하세요.

    using IronWord;
    using IronWord.Models;
    
    WordDocument doc = new WordDocument();
    TextStyle textStyle = new TextStyle();
    textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Shadow Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("shadow.docx");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronWord 사용 시작하기

    arrow pointer

텍스트에 그림자 효과를 추가하는 방법은 무엇인가요?

To apply a shadow effect, create a TextStyle and populate its TextEffect property with a ShadowEffect. Then create a Paragraph, followed by a Run containing TextContent. Assign the TextStyle to the Run (not the TextContent), then use AddChild to add the Run to the Paragraph. 이는 문서 계층 구조(문서 → 단락 → 실행 → 텍스트 콘텐츠)를 따릅니다.

구현 과정은 기존 문서 생성 워크플로와 원활하게 통합되는 간단한 패턴을 따릅니다. 자동 보고서 작성, 인증서 생성 또는 브랜드 문서 제작 등 어떤 작업을 하든 그림자 효과는 텍스트 요소에 전문적인 느낌을 더해줍니다. 라이선스 옵션을 고려 중인 조직의 경우, IronWord의 섀도우 이펙트는 모든 라이선스 등급에 포함되어 개발, 테스트 및 프로덕션 환경 전반에서 일관된 기능을 보장합니다.

사용 가능한 그림자 효과 사전 설정에는 어떤 것들이 있습니까?

IronWord는 OuterShadow1부터 OuterShadow20까지 다양한 시각 스타일을 제공하는 여러 가지 내장된 그림자 프리셋을 제공합니다. 이러한 사전 설정은 수동 구성 없이 신속하게 적용할 수 있도록 해줍니다. 각 사전 설정은 전문적인 문서 작성에서 흔히 사용되는 사례에 맞춰 세심하게 설계되었습니다.

  • OuterShadow1-5 : 본문 및 제목에 은은한 그림자 효과 적용
  • OuterShadow6-10 : 제목 및 강조를 위한 중간 강도의 그림자
  • OuterShadow11-15 : 표지 및 섹션 구분선에 굵은 그림자 효과 적용
  • OuterShadow16-20 : 프레젠테이션 및 창작 문서에 극적인 효과를 더합니다.

새로운 사전 설정 추가 및 개선 사항에 대한 최신 정보를 확인하려면 변경 로그를 정기적으로 확인하세요. 개발팀은 사용자 피드백과 업계 동향을 바탕으로 이러한 사전 설정들을 지속적으로 개선합니다.

사전 설정된 그림자 효과와 사용자 지정 그림자 효과는 언제 사용해야 할까요?

표준 문서 서식 및 빠른 적용을 위해 미리 설정된 그림자를 사용하십시오. 특정 브랜딩 요구 사항이나 사전 설정에서 제공하지 않는 독특한 시각 효과가 필요할 때는 사용자 지정 그림자를 선택하세요. 사전 설정 그림자는 기업 템플릿이나 표준 보고서처럼 여러 문서에서 일관성이 중요한 경우에 유용합니다.

브랜드 가이드라인에 따라 정확한 색상 값, 위치 또는 흐림 효과를 지정할 때 사용자 지정 그림자는 매우 유용합니다. 마케팅 팀은 모든 홍보 자료에서 시각적 정체성을 유지하기 위해 정확한 섀도우 스펙이 필요한 경우가 많습니다. 또한, 사용자 지정 그림자를 사용하면 여러 겹의 그림자나 특정 배경색과 조화를 이루는 그림자와 같은 창의적인 효과를 낼 수 있습니다.

기본 구현 패턴이란 무엇인가요?

WordDocument를 생성하고, TextStyleShadowEffect로 구성하여 스타일을 텍스트에 적용하고 문서를 저장합니다. 사전 설정값을 사용하든 사용자 지정 구성을 사용하든 패턴은 일관되게 유지됩니다.

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

// 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("shadowEffect.docx");
$vbLabelText   $csharpLabel
'Hello World' 텍스트가 표시된 Microsoft Word 문서이며, 서식 도구가 있는 홈 리본 메뉴가 나타납니다.

그림자 효과 속성을 어떻게 사용자 지정할 수 있나요?

미리 정의된 그림자 값을 지정하는 것 외에도 그림자 효과의 모든 속성을 구성할 수 있습니다. 이를 통해 그림자 효과를 원하는 대로 자유롭게 설정할 수 있습니다. 아래에서 속성과 그 설명을 확인하세요.

라이선스 연장 또는 업그레이드를 검토하는 팀의 경우, 사용자 지정 그림자 효과는 IronWord가 Enterprise급 문서 조작 기능을 제공하기 위해 기울이는 노력을 보여줍니다. 다양한 맞춤 설정 옵션을 통해 IronWord 에 투자한 비용은 문서 처리 요구 사항의 증가에 맞춰 확장될 수 있습니다.

그림자 위치를 제어하는 ​​속성은 무엇입니까?

  • 정렬 : 그림자의 정렬을 가져오거나 설정합니다.
  • DirectionAngle : 그림자 효과의 방향 각도를 가져오거나 설정합니다. 방향각은 도 단위로 표시됩니다.
  • DistanceFromText : 그림자 효과와 텍스트 또는 개체 사이의 거리를 가져오거나 설정합니다. 거리는 포인트(1/72인치) 단위로 표시됩니다.

이러한 위치 지정 속성들이 함께 작용하여 사실적인 그림자 효과를 만들어냅니다. Alignment 속성은 텍스트에 대한 그림자의 앵커 포인트를 결정하고, DirectionAngle은 빛의 방향을 시뮬레이션합니다. DistanceFromText은 페이지 표면 위의 텍스트의 인식되는 높이를 제어합니다. 이러한 속성들을 효과적으로 결합하면 문서 전체에 걸쳐 일정한 광원에서 나오는 것처럼 보이는 그림자를 만들 수 있습니다.

그림자 모양에 영향을 미치는 속성은 무엇입니까?

  • BlurRadius : 그림자 효과의 흐림 반경을 가져오거나 설정합니다. 흐림 반경은 포인트(1/72인치) 단위로 지정됩니다.
  • SchemeColor : 그림자 효과의 색상 구성표를 가져오거나 설정합니다.

외관 속성은 그림자의 시각적 품질에 직접적인 영향을 미칩니다. BlurRadius는 부드럽거나 날카로운 그림자 가장자리를 만들어냅니다. 값이 낮을수록 기술 문서에 적합한 선명한 그림자를 생성하고, 값이 높을수록 창의적 디자인에 이상적인 확산된 그림자를 만듭니다. SchemeColor을 사용하면 문서의 색상 팔레트와 그림자를 일치시켜 콘텐츠 전체의 시각적 일관성을 유지할 수 있습니다.

그림자 크기 조절 및 왜곡은 어떻게 제어하나요?

  • HorizontalScalingFactor : 그림자 효과의 가로 확대/축소 배율을 가져오거나 설정합니다.
  • HorizontalSkewAngle : 그림자 효과의 수평 기울기 각도를 가져오거나 설정합니다. 비스듬한 각도는 도 단위로 표시됩니다.
  • VerticalScalingFactor : 그림자 효과의 세로 확대/축소 배율을 가져오거나 설정합니다.
  • VerticalSkewAngle : 그림자 효과의 수직 기울기 각도를 가져오거나 설정합니다. 비스듬한 각도는 도 단위로 표시됩니다.

확대/축소 및 기울이기 속성을 사용하면 텍스트에 입체감을 더하는 원근 효과를 구현할 수 있습니다. HorizontalScalingFactorVerticalScalingFactor는 그림자를 늘리거나 압축하여 서로 다른 시야각을 시뮬레이션하는 효과를 만듭니다. 기울기 각도를 사용하면 기울임꼴 그림자 효과를 만들거나 경사진 표면에 드리워진 그림자를 시뮬레이션하여 문서에 세련된 시각적 깊이를 더할 수 있습니다.

일반적인 부동산 가치 범위는 무엇인가요?

BlurRadius은 일반적으로 0-10 포인트 범위에서, DirectionAngle은 0-360도 범위이며, 스케일링 요소는 백분율 값(100 = 정상 크기)을 사용합니다. DistanceFromText은 일반적으로 미묘한 효과를 위해 1-5 포인트 사이에서 가장 잘 작동합니다.

이러한 범위들을 이해하면 전문가 수준의 결과를 빠르게 얻을 수 있습니다. 비즈니스 문서의 경우 보수적인 값(BlurRadius: 2-4, DistanceFromText: 1-2)이 가독성을 유지하면서 시각적 흥미를 더합니다. 창의적 응용에서는 극적인 효과(BlurRadius: 8-10, DistanceFromText: 4-6)를 통해 이러한 경계를 넘을 수도 있습니다. 프린터 성능과 화면 해상도가 그림자 표현에 영향을 미치므로, 의도한 출력 방식에서 문서를 테스트해 보는 것이 중요합니다.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-shadow-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()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedShadowEffect.docx");
$vbLabelText   $csharpLabel
맞춤형 그림자 효과

자주 묻는 질문

C# Word 문서에서 텍스트에 그림자 효과를 어떻게 추가하나요?

IronWord를 사용하여 그림자 효과를 추가하려면 TextStyle 객체를 생성하고 그 ShadowEffect 속성을 Shadow 객체로 채워야 합니다. OuterShadow1과 같은 프리셋 그림자를 사용할 수 있으며 흐림, 거리, 색상과 같은 속성을 사용자 지정할 수 있습니다. 그런 다음 문서에 텍스트를 추가할 때 이 스타일을 적용하세요.

사용자 정의 없이 프리셋 그림자 효과를 빠르게 적용할 수 있나요?

예, IronWord는 빠른 구현을 위한 프리셋 그림자 옵션을 제공합니다. 한 줄의 코드만으로 그림자 효과를 적용할 수 있습니다: new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };

어떤 그림자 사용자 정의 옵션들이 제공되나요?

IronWord는 흐림 정도, 텍스트로부터의 거리, 그림자 색상 및 위치 오프셋을 포함한 다양한 그림자 속성을 사용자 지정할 수 있도록 합니다. 이를 통해 프리셋 옵션을 넘어 브랜드 요구에 맞는 독특한 그림자 효과를 생성할 수 있습니다.

그림자 효과를 사용하려면 특별 라이센스가 필요합니까?

그림자 효과는 모든 IronWord 라이센스 계층에 포함되어 있습니다. 그러나 그림자와 같은 텍스트 효과를 구현할 때 프로덕션 문서에서 워터마크가 나타나지 않도록 라이센스 키를 제대로 구성해야 합니다.

Word 문서에서 그림자 효과는 무엇에 유용한가요?

IronWord의 그림자 효과는 텍스트가 돋보여야 하는 전문 문서, 프레젠테이션, 보고서를 만들 때 특히 유용합니다. 텍스트 요소에 깊이와 시각적 구분을 추가하여 자동 보고서, 인증서 및 브랜드 문서에 이상적입니다.

커티스 차우
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 35,581 | 버전: 2026.3 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronWord
샘플 실행 데이터를 워드 문서로 변환 확인.