C#에서 텍스트에 반사 효과를 추가하는 방법 | IronWord

How to Add Reflection Effect to Text in C#

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

IronWord의 간단한 API를 사용하여 C#에서 텍스트에 거울처럼 반사되는 효과를 적용하세요. 단 한 줄의 코드로 표면에 반사된 텍스트와 같은 전문적인 텍스트 반사 효과를 만들어 시각적 깊이감을 높여보세요.

빠른 시작: C#에서 텍스트에 반사 효과 적용하기

IronWord 사용하면 단 한 줄의 코드로 모든 텍스트에 미리 설정된 반사 효과를 적용할 수 있습니다. 복잡한 설정이나 반복적인 코드 작성 없이 즉시 시작할 수 있습니다.

  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() { ReflectionEffect = new Reflection() };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Reflection Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("reflection.docx");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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

    arrow pointer

반사 효과를 어떻게 추가하나요?

To apply a reflection effect, create a TextStyle and populate its TextEffect property with a ReflectionEffect. 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. 이는 문서 계층 구조(문서 → 단락 → 실행 → 텍스트 콘텐츠)를 따릅니다.

반사 효과는 중요한 텍스트 요소에 깊이감과 시각적 흥미를 더하여 문서의 표현력을 향상시킵니다. 이 효과는 특히 전문 문서에서 제목, 표제, 핵심 정보 강조 등에 효과적입니다. 반사 효과는 마치 광택 있는 표면 위에 놓인 글자처럼 보여 우아하고 현대적인 느낌을 자아내 독자의 시선을 사로잡습니다.

TextStyle을(를) 생성하는 것이 왜 중요할까요?

TextStyle 객체는 IronWord에서 모든 텍스트 서식을 위한 중앙 설정 지점으로 기능합니다. 스타일과 콘텐츠를 분리하면 여러 텍스트 요소에 동일한 반사 효과를 재사용할 수 있으므로 문서 전체의 일관성을 유지할 수 있습니다. 이러한 접근 방식을 사용하면 단일 스타일 객체를 수정하여 반사 효과를 전역적으로 쉽게 업데이트할 수 있습니다.

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-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()
{
    ReflectionEffect = new Reflection(),
};

// 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("reflectionEffect.docx");
$vbLabelText   $csharpLabel

기본 반사 이미지는 어떻게 생겼나요?

기본 반사 효과는 텍스트 아래에 은은한 거울 이미지를 만들고, 투명도가 자동으로 점차 낮아집니다. 이 사전 설정 구성은 추가적인 사용자 지정 없이 대부분의 비즈니스 문서 및 프레젠테이션에 적합합니다. 반사된 이미지는 다양한 글꼴 크기와 스타일에 맞춰 적절한 흐림 및 투명도 설정으로 표준 거리에서 나타납니다.

마이크로소프트 워드에서 'Hello World' 텍스트에 반사 효과를 적용하여 아래쪽에 반투명한 복사본이 나타나도록 한 화면입니다.

반사 효과에 대해 어떤 속성을 설정할 수 있나요?

반사 효과는 다양한 설계 요구 사항을 충족하기 위해 조정 가능한 여러 속성을 제공합니다. 이러한 속성을 이해하면 특정 문서 스타일에 맞춰 독특한 시각 효과를 만들 수 있습니다. 각 속성은 반사의 위치와 각도부터 투명도와 색상에 이르기까지 반사의 다양한 측면을 제어합니다. 각 속성에 대한 자세한 설명은 다음 목록을 참조하십시오.

반사광의 모양을 좌우하는 속성은 무엇입니까?

  • SchemeColor: 반사 효과의 스킴 색상을 가져오거나 설정합니다. 물이나 금속 표면 효과를 위해 반사광에 원하는 색상을 입힐 수 있습니다.

  • HorizontalSkewAngle: 수평 왜곡 각도를 도 단위로 가져오거나 설정합니다. 반사된 이미지가 멀리 사라지는 원근 효과를 만들어 보세요.

  • HorizontalScalingFactor: 수평 확대 비율을 가져오거나 설정합니다. 100 미만의 값은 압축됩니다. 100 이상의 값은 늘어납니다.

  • DistanceFromText: 포인트 단위(1/72 인치)로 거리 가져오거나 설정합니다. 값이 작을수록 반사가 촘촘해집니다. 값이 클수록 멀리 떨어진 표면을 시뮬레이션합니다.

  • DirectionAngle: 도 단위로 방향 각도를 가져오거나 설정합니다. 겉으로 보이는 광원의 방향을 결정합니다.

  • FadeDirectionAngle: 도 단위로 페이드 방향을 가져오거나 설정합니다. 바닥 반사에는 수직 페이드 효과를, 물 효과에는 각도 페이드 효과를 적용하세요.

  • EndPosition: 종료 위치를 가져오거나 설정합니다. 반사광이 완전히 사라지는 지점을 결정합니다.

  • StartPosition: 시작 위치를 가져오거나 설정합니다. 일반적으로 0은 텍스트 바로 아래에서 시작됩니다.

  • EndingOpacity: 종료 불투명도를 가져오거나 설정합니다. 값이 낮을수록 은은한 반사가 일어나다가 점차 투명해집니다.

  • VerticalScalingFactor: 수직 확대 비율을 가져오거나 설정합니다. 음수 값은 텍스트를 뒤집습니다. 크기가 높이를 조절합니다.

  • StartingOpacity: 시작 불투명도를 가져오거나 설정합니다. 값이 높을수록 초기 반사가 더 강해집니다.

  • Alignment: 정렬을 가져오거나 설정합니다. 다양한 옵션 중에서 선택하여 반사된 이미지를 텍스트에 상대적으로 배치하세요.

  • BlurRadius: 포인트 단위(1/72 인치)로 블러 반경을 가져오거나 설정합니다. 값이 높을수록 더 부드럽고 확산된 반사가 생성됩니다.

  • VerticalSkewAngle: 수직 왜곡 각도를 도 단위로 가져오거나 설정합니다. 비스듬한 반사 효과를 만들 때 사용합니다.

사용자 지정 반사 효과를 어떻게 만들 수 있나요?

맞춤형 반사 효과를 사용하면 조직의 브랜딩에 맞추거나 고유한 시각적 스타일을 만들 수 있습니다. 다음 예시는 특정 위치 및 불투명도 설정을 통해 금색 반사 효과를 적용하여 인증서, 상장 또는 고급 문서 헤더에 전문적인 느낌을 연출하는 방법을 보여줍니다.

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-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()
{
    ReflectionEffect = new Reflection()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 90,
        DistanceFromText = 5,
        EndingOpacity = 100,
        EndPosition = 10,
        FadeDirectionAngle = 90,
        HorizontalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Gold,
        StartingOpacity = 0,
        StartPosition = 0,
        VerticalScalingFactor = -100,
        VerticalSkewAngle = 0,
    },
};

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

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

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

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

// Export new Word document
doc.SaveAs("customizedReflectionEffect.docx");
$vbLabelText   $csharpLabel

사용자 지정 속성을 사용하면 어떤 결과를 얻을 수 있나요?

위의 맞춤형 반사 예시는 문서의 고급스러운 느낌을 더욱 돋보이게 하는 독특한 금빛 반사 효과를 만들어냅니다. 불투명도 그라디언트를 0%에서 100%까지 조정하면 반사광이 텍스트에서 멀어질수록 강해지는 역페이드 효과가 나타납니다. 이 기법은 눈에 띄는 제목을 만들거나 중요한 공지 사항을 강조하는 데 효과적입니다.

회색 거울 반사 효과가 적용된 '사용자 지정 반사' 텍스트가 표시된 워드 문서

반사 효과를 위한 모범 사례

전문 문서에 반사 효과를 적용할 때는 다음 지침을 고려하십시오.

미묘한 효과가 가장 좋을 때가 많습니다 . 비즈니스 문서의 경우, 시선을 분산시키지 않으면서도 은은한 반사 효과를 내려면 낮은 불투명도 값(20~40%)을 사용하는 것이 좋습니다. 시각적 효과가 가장 중요한 마케팅 자료나 프레젠테이션에 더 강력한 효과를 사용하십시오.

문서 스타일과 일치시키세요 : 반사 속성을 문서의 전체적인 디자인과 일치시키세요. 공식적인 문서에는 흐림 효과가 최소화된 단순한 수직 반사가 적합하며, 창의적인 자료에는 예술적 효과를 위해 비스듬한 각도와 색상이 있는 반사를 활용할 수 있습니다.

성능 고려 사항 : 흐림 반경 값이 큰 복잡한 반사 효과는 파일 크기와 처리 시간을 증가시킬 수 있습니다. 반사되는 요소가 많은 문서의 경우 성능을 테스트하고 필요에 따라 속성을 조정하십시오.

접근성 고려 사항 : 반사와 같은 장식 효과는 명확한 정보 전달을 대체하는 것이 아니라 보완하는 역할을 해야 한다는 점을 기억하십시오. 특히 접근성 기준을 충족해야 하는 문서를 작성할 때는 기본 텍스트의 가독성을 최대한 유지해야 합니다.

자주 묻는 질문

C#에서 텍스트에 반사 효과를 추가하려면 어떻게 하나요?

IronWord를 사용하면 TextStyle 객체를 생성하고 Reflection 객체로 ReflectionEffect 속성을 채워서 반사 효과를 추가할 수 있습니다. 단순히 Reflection 클래스를 인스턴스화하고 이를 텍스트 스타일에 할당하기만 하면 IronWord가 모든 복잡한 렌더링을 자동으로 처리합니다.

텍스트 반사 효과를 가장 간단히 적용하는 방법은 무엇인가요?

가장 빠른 방법은 IronWord의 한 줄 구현을 사용하는 것입니다: new IronWord.WordDocument().AddText("Your Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() } }. 이 방법은 즉시 기본 반사 효과를 적용합니다.

반사 효과 속성을 맞춤화할 수 있나요?

예, IronWord의 Reflection 클래스는 불투명도 페이드, 텍스트와의 거리, 블러 설정 및 투명도 수준 등을 포함하여 반사의 외형을 조정할 수 있는 다양한 구성 가능한 속성을 제공합니다. 이러한 속성을 세밀히 조정하여 특정 디자인 요구 사항에 맞춘 독특한 시각적 효과를 만들어낼 수 있습니다.

기본 반사 효과는 어떻게 보이나요?

IronWord의 기본 반사는 텍스트 아래에 미묘한 거울 이미지를 생성하며 자동 불투명도 페이드를 제공합니다. 미리 설정된 구성은 다양한 글꼴 크기와 스타일에 잘 맞는 적절한 블러 및 투명도 설정을 포함하여 추가적인 맞춤화 없이 대부분의 비즈니스 문서에 적합하게 만듭니다.

반사 효과를 위해 TextStyle 객체를 사용해야 하는 이유는 무엇인가요?

IronWord의 TextStyle 객체는 모든 텍스트 서식을 위한 중심 구성 지점 역할을 합니다. 스타일과 콘텐츠의 분리는 동일한 반사 효과를 여러 텍스트 요소에 걸쳐 재사용하도록 하여 일관성을 보장하고, 단일 스타일 객체를 수정하여 전 세계적으로 효과를 쉽게 업데이트할 수 있게 합니다.

어떤 유형의 문서가 반사 효과로 혜택을 받을 수 있나요?

반사 효과는 특히 머리글, 제목, 전문 문서에서 중요한 정보를 강조하는 데 잘 작동합니다. IronWord의 반사 기능은 광택 표면 위에 놓여 있는 텍스트를 시뮬레이션하여 문서 프레젠테이션을 향상시키고 독자의 주의를 중요한 요소로 끌어올리는 우아한 외형을 만들어냅니다.

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

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

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

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

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

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