C#에서 텍스트에 그라디언트 효과를 추가하는 방법

그라데이션 텍스트를 만들려면 어떤 단계가 필요합니까?

그라데이션 효과를 적용하려면 IronWord의 다중 단계 패턴을 따르세요: TextStyle을 생성하고 그것의 TextEffect 속성을 GradientEffect으로 채웁니다. 그런 다음 Paragraph을 생성하고, 이어서 Run에 TextContent을 포함하여 생성합니다. ##TextStyle을 Run(으)로 할당하고, TextContent가 아닌 다음에 AddChild을 사용하여 Run을(를) Paragraph에 추가하세요. 이는 문서 계층 구조(문서 → 단락 → 실행 → 텍스트 콘텐츠)를 따릅니다.

:path=/static-assets/word/content-code-examples/how-to/text-effect-gradient-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()
{
    GradientEffect = Gradient.DefaultGray,
};

// 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("gradientEffect.docx");

어떤 내장 그라디언트 옵션이 있나요?

IronWord는 사용자 정의 구성 없이 즉시 적용할 수 있는 DefaultGray 및 기타 색상 조합을 포함하여 여러 기본 그라데이션 프리셋을 제공합니다. 이 프리셋은 Gradient 클래스의 정적 속성을 통해 액세스할 수 있습니다. 이러한 사전 설정은 Microsoft Word의 텍스트 서식 대화 상자에서 볼 수 있는 것과 유사한 빠른 스타일 지정 옵션을 제공합니다. 내장된 그라데이션 기능은 표준 문서 템플릿과 호환되며 다양한 문서 형식에서 가독성을 유지합니다.

실제 운영 환경에서 그라디언트 효과를 사용할 때는 배포 시나리오에 맞는 적절한 라이선스 범위가 확보되어 있는지 라이선스 옵션을 검토하는 것이 중요합니다.

그라디언트 정지는 어떻게 작동하나요?

그라디언트 효과는 다양한 디자인 요구에 맞춰 조정 가능한 속성을 제공합니다. 각 속성에 대한 자세한 설명은 다음 목록을 참조하십시오.

그래디언트스톱

• 색상 : 그라디언트 정지점의 색상표를 가져오거나 설정합니다. 색상은 IronWord의 사전 정의된 색상 상수 또는 사용자 지정 RGB 값을 사용하여 지정할 수 있습니다.
• 정지점 : 경사 정지 지점의 위치를 ​​가져오거나 설정합니다. 값은 일반적으로 0에서 100 사이의 값을 가지며, 경사 경로를 따라 백분율 위치를 나타냅니다.

그라디언트 정지점은 그라디언트 내에서 특정 색상이 정의되는 지점입니다. 여러 개의 정지점을 사용하면 색상 간에 부드러운 전환이 만들어지고, 정지점 사이의 간격은 색상 변화가 얼마나 점진적이거나 급격하게 보이는지를 결정합니다.

구배

• 정지점 : 그라디언트 채우기를 정의하는 그라디언트 정지점 목록을 가져오거나 설정합니다. 기본 경사로를 위해서는 최소 두 번의 정지가 필요합니다.
• LinearShadeScaled : 선형 음영의 크기 조절 여부를 나타내는 값을 가져오거나 설정합니다. 이 값이 true이면 그라디언트가 텍스트 경계에 맞춰 조정됩니다.
• LinearShadeAngle : 선형 셰이드의 각도를 가져오거나 설정합니다. 이 속성은 텍스트를 가로지르는 그라디언트 흐름의 방향을 제어합니다.

문서 처리 기능을 확장하려는 팀의 경우, 업그레이드 옵션을 통해 여러 프로젝트와 개발자에 걸쳐 구현을 확장할 수 있는 유연한 경로를 제공합니다.

사용자 지정 그라디언트 효과를 어떻게 만들 수 있나요?

사용자 지정 그라데이션 효과를 생성하면 브랜드 또는 디자인 요구 사항에 맞는 독특한 텍스트 스타일을 만들 수 있습니다. 다음 예제는 특정 각도 및 크기 조정 속성을 가진 두 가지 색상의 그라디언트를 만드는 방법을 보여줍니다. 그라디언트 효과와 관련된 최신 기능 및 개선 사항은 제품 변경 로그를 확인하세요.

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

using IronWord;
using IronWord.Models;
using System.Collections.Generic;

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

// Create gradient stops
GradientStop firstGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.Aqua,
    StopPoint = 1
};
GradientStop secondGradientStop = new GradientStop()
{
    Color = IronWord.Models.Color.OrangeRed,
    StopPoint = 10
};

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    GradientEffect = new Gradient()
    {
        StopPoints = new List<GradientStop> { firstGradientStop, secondGradientStop },
        LinearShadeAngle = 45,
        LinearShadeScaled = true,
    }
};

// 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("customizedGradientEffect.docx");

어떤 각도 값이 서로 다른 효과를 만들어낼까요?

LinearShadeAngle은 0도에서 360도까지의 값을 허용하며, 0°는 왼쪽에서 오른쪽으로의 수평 그라디언트를, 90°는 위에서 아래로의 수직 그라디언트를, 45°는 위 예시와 같이 대각선 그라디언트 효과를 생성합니다. 일반적인 각도 구성은 다음과 같습니다.

• 0° (수평 좌우 방향) : 좌우로 기울어진 그라데이션을 생성하여 현대적인 제목에 적합합니다.
• 90° (수직 상하 방향) : 위에서 아래로 서서히 밝아지는 효과를 냅니다. -45°(대각선) : 모서리에서 모서리로의 전환을 생성합니다.
• 180° (수평 우측에서 좌측) : 표준 수평 기울기 방향을 반전시킵니다.
• 270° (수직 아래에서 위로) : 위쪽으로 향하는 그라데이션 효과를 만듭니다.

여러 문서 또는 템플릿에 걸쳐 그라데이션 효과를 적용할 때는 지속적인 업데이트 및 지원을 보장하기 위해 라이선스 연장을 고려하십시오.

그라데이션 텍스트 효과를 위한 모범 사례

전문 문서에서 텍스트에 그라데이션 효과를 적용할 때는 다음 지침을 고려하십시오.

1. 가독성 최우선 : 그라데이션 색상과 문서 배경 사이에 충분한 대비를 확보하십시오.
2. 색상 조화 : 문서의 전체적인 디자인 구성과 어울리는 색상을 선택하세요.
3. 비즈니스 문서에서의 은은함 : 공식적인 문서에는 강렬한 색상 전환보다는 부드러운 그라데이션을 사용하는 것이 좋습니다.
4. 성능 고려 사항 : 정지점이 많은 복잡한 그라디언트는 문서 렌더링 속도에 영향을 미칠 수 있습니다.
5. 플랫폼 간 호환성 : 다양한 Word 뷰어 및 PDF 내보내기 프로그램에서 그라디언트 모양이 제대로 표시되는지 테스트합니다.

그라데이션 효과는 장 제목, 섹션 머리글, 강조 텍스트와 같이 시각적 강조를 통해 독자의 탐색 경험을 향상시키는 문서 요소에 특히 효과적입니다.