.NET에서 프레젠테이션 텍스트 서식 지정

이 페이지의 내용

Aspose.Slides for .NET을 사용하여 PowerPoint 및 OpenDocument 프레젠테이션의 텍스트를 서식 지정하고 스타일을 적용합니다. 글꼴, 색상, 정렬 등을 사용자 지정할 수 있습니다.

개요

이 문서에서는 Aspose.Slides for .NET을 사용하여 PowerPoint 및 OpenDocument 프레젠테이션에서 텍스트를 서식 지정하는 방법을 보여줍니다. 배경 색, 투명도, 문자 간격, 글꼴 속성, 회전, 단락 간격, 자동 맞춤 동작, 텍스트 앵커링, 탭 정지 및 언어 설정을 포함합니다.

아래 예제에서는 첫 번째 슬라이드에 단일 텍스트 상자가 포함된 “sample.pptx” 파일을 사용합니다.

리터럴 텍스트 또는 정규식 일치를 찾고 강조 표시하려면 텍스트 검색 및 교체를 참조하십시오.

텍스트 배경 색 설정

IParagraphFormat.DefaultPortionFormat을 사용하여 단락의 기본 강조 색을 설정하거나, 개별 텍스트 구간에는 IBasePortionFormat.HighlightColor를 사용합니다.

다음 코드 예제는 전체 단락의 배경 색을 설정하는 방법을 보여줍니다:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    // 전체 단락에 대한 강조 색을 설정합니다.
    paragraph.ParagraphFormat.DefaultPortionFormat.HighlightColor.Color = Color.LightGray;

    presentation.Save("gray_paragraph.pptx", SaveFormat.Pptx);
}

결과:

아래 코드 예제는 굵은 글꼴이 적용된 텍스트 구간의 배경 색을 설정하는 방법을 보여줍니다:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    foreach (var portion in paragraph.Portions)
    {
        if (portion.PortionFormat.GetEffective().FontBold)
        {
            // 텍스트 구간에 대한 강조 색을 설정합니다.
            portion.PortionFormat.HighlightColor.Color = Color.LightGray;
        }
    }

    presentation.Save("gray_text_portions.pptx", SaveFormat.Pptx);
}

결과:

텍스트 단락 정렬

IParagraphFormat.Alignment을 사용하여 텍스트 프레임 내에서 단락 정렬을 설정합니다. 값은 가운데, 왼쪽 정렬, 오른쪽 정렬, 양쪽 맞춤 등으로 지정할 수 있습니다.

다음 코드 예제는 단락을 가운데에 정렬하는 방법을 보여줍니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    // 단락의 정렬을 가운데로 설정합니다.
    paragraph.ParagraphFormat.Alignment = TextAlignment.Center;

    presentation.Save("aligned_paragraph.pptx", SaveFormat.Pptx);
}

결과:

텍스트 투명도 설정

텍스트 투명도는 IBasePortionFormat.FillFormat에 할당된 색상의 알파 구성 요소를 통해 제어됩니다. 아래 예제에서 alpha = 50은 0–255 스케일의 ARGB 알파값이며 투명도 백분율이 아닙니다.

다음 코드 예제는 전체 단락에 투명도를 적용하는 방법을 보여줍니다:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

int alpha = 50;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    // 텍스트의 채우기 색상을 투명 색으로 설정합니다.
    paragraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    paragraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(alpha, Color.Black);

    presentation.Save("transparent_paragraph.pptx", SaveFormat.Pptx);
}

결과:

다음 코드 예제는 굵은 글꼴이 적용된 텍스트 구간에 투명도를 적용하는 방법을 보여줍니다:

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

int alpha = 50;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    foreach (var portion in paragraph.Portions)
    {
        if (portion.PortionFormat.GetEffective().FontBold)
        {
            // 텍스트 구간의 투명도를 설정합니다.
            portion.PortionFormat.FillFormat.FillType = FillType.Solid;
            portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(alpha, Color.Black);
        }
    }

    presentation.Save("transparent_text_portions.pptx", SaveFormat.Pptx);
}

결과:

텍스트 문자 간격 설정

IBasePortionFormat.Spacing을 사용하여 텍스트 상자 내 문자 간격을 확대하거나 축소합니다.

다음 C# 코드는 전체 단락의 문자 간격을 확대하는 방법을 보여줍니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    // 참고: 문자 간격을 압축하려면 음수 값을 사용합니다.
    paragraph.ParagraphFormat.DefaultPortionFormat.Spacing = 3;  // 문자 간격을 확대합니다.

    presentation.Save("character_spacing_in_paragraph.pptx", SaveFormat.Pptx);
}

결과:

아래 코드 예제는 굵은 글꼴이 적용된 텍스트 구간의 문자 간격을 확대하는 방법을 보여줍니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    foreach (var portion in paragraph.Portions)
    {
        if (portion.PortionFormat.GetEffective().FontBold)
        {
            // 참고: 문자 간격을 압축하려면 음수 값을 사용합니다.
            portion.PortionFormat.Spacing = 3;  // 문자 간격을 확대합니다.
        }
    }

    presentation.Save("character_spacing_in_text_portions.pptx", SaveFormat.Pptx);
}

결과:

특정 폰트에 대한 커닝 비활성화

때때로 Aspose.Slides가 렌더링한 텍스트는 PowerPoint에서 표시되는 텍스트보다 약간 더 촘촘해 보일 수 있습니다. 이는 PowerPoint가 특정 폰트에 대해 커닝 데이터를 무시할 때 발생할 수 있으며, 해당 폰트에 유효한 커닝 정보가 포함되어 있고 PowerPoint 설정에서 커닝이 활성화되어 있더라도 마찬가지입니다.

이러한 경우 렌더링 결과를 PowerPoint와 더 가깝게 만들려면 영향을 받는 폰트를 사용하는 텍스트 구간에 대해 커닝을 비활성화할 수 있습니다. 실제 폰트 크기보다 크게 IBasePortionFormat.KerningMinimalSize를 설정합니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("presentation.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var targetFont = "Roboto";

    foreach (var paragraph in autoShape.TextFrame.Paragraphs)
    {
        foreach (var portion in paragraph.Portions)
        {
            if ((portion.PortionFormat.LatinFont != null &&
                 portion.PortionFormat.LatinFont.FontName == targetFont) ||
                (portion.PortionFormat.EastAsianFont != null &&
                 portion.PortionFormat.EastAsianFont.FontName == targetFont) ||
                (portion.PortionFormat.ComplexScriptFont != null &&
                 portion.PortionFormat.ComplexScriptFont.FontName == targetFont))
            {
                portion.PortionFormat.KerningMinimalSize = 100;
            }
        }
    }

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

이 설정은 일치하는 텍스트 구간에 커닝이 적용되는 것을 방지하며, PowerPoint 고유 동작으로 인해 영향을 받는 폰트의 시각적 출력을 Aspose.Slides 렌더링과 일치시키는 데 도움이 될 수 있습니다.

텍스트 폰트 속성 관리

폰트 속성은 IParagraphFormat.DefaultPortionFormat을 통해 단락 수준에서 설정하거나, 개별 구간은 IPortionFormat을 통해 설정할 수 있습니다.

다음 코드는 전체 단락에 대해 글꼴 및 텍스트 스타일을 설정합니다. 여기에는 글꼴 크기, 굵게, 기울임꼴, 점선 밑줄 및 Times New Roman 폰트가 모든 구간에 적용됩니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    // 단락에 대한 폰트 속성을 설정합니다.
    paragraph.ParagraphFormat.DefaultPortionFormat.FontHeight = 12;
    paragraph.ParagraphFormat.DefaultPortionFormat.FontBold = NullableBool.True;
    paragraph.ParagraphFormat.DefaultPortionFormat.FontItalic = NullableBool.True;
    paragraph.ParagraphFormat.DefaultPortionFormat.FontUnderline = TextUnderlineType.Dotted;
    paragraph.ParagraphFormat.DefaultPortionFormat.LatinFont = new FontData("Times New Roman");

    presentation.Save("font_properties_for_paragraph.pptx", SaveFormat.Pptx);
}

결과:

아래 코드 예제는 굵은 글꼴이 적용된 텍스트 구간에 유사한 속성을 적용합니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    foreach (var portion in paragraph.Portions)
    {
        if (portion.PortionFormat.GetEffective().FontBold)
        {
            // 텍스트 구간에 대한 폰트 속성을 설정합니다.
            portion.PortionFormat.FontHeight = 13;
            portion.PortionFormat.FontItalic = NullableBool.True;
            portion.PortionFormat.FontUnderline = TextUnderlineType.Dotted;
            portion.PortionFormat.LatinFont = new FontData("Times New Roman");
        }
    }

    presentation.Save("font_properties_for_text_portions.pptx", SaveFormat.Pptx);
}

결과:

텍스트 회전 설정

ITextFrameFormat.TextVerticalType을 사용하여 도형 내에서 미리 정의된 텍스트 방향을 설정합니다.

다음 코드 예제는 텍스트 방향을 Vertical270으로 설정하여 텍스트를 시계 반대 방향으로 90도 회전시킵니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];

    autoShape.TextFrame.TextFrameFormat.TextVerticalType = TextVerticalType.Vertical270;

    presentation.Save("text_rotation.pptx", SaveFormat.Pptx);
}

결과:

텍스트 프레임에 대한 사용자 정의 회전 설정

ITextFrameFormat.RotationAngle을 사용하여 ITextFrame에 대한 사용자 정의 회전 각도를 설정합니다.

아래 코드 예제는 도형 내에서 텍스트 프레임을 시계 방향으로 3도 회전시킵니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];

    autoShape.TextFrame.TextFrameFormat.RotationAngle = 3;

    presentation.Save("custom_text_rotation.pptx", SaveFormat.Pptx);
}

결과:

단락 줄 간격 설정

Aspose.Slides는 IParagraphFormat.SpaceAfter, IParagraphFormat.SpaceBefore, 및 IParagraphFormat.SpaceWithin을 제공하여 단락 간격을 제어합니다. 이러한 속성은 다음과 같이 사용됩니다:

• 양수 값을 사용하면 줄 간격을 줄 높이의 백분율로 지정합니다.
• 음수 값을 사용하면 줄 간격을 포인트 단위로 지정합니다.

다음 코드 예제는 단락 내에서 줄 간격을 지정하는 방법을 보여줍니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    paragraph.ParagraphFormat.SpaceWithin = 200;

    presentation.Save("line_spacing.pptx", SaveFormat.Pptx);
}

결과:

텍스트 프레임 자동 맞춤 유형 설정

ITextFrameFormat.AutofitType은 텍스트가 컨테이너 경계를 초과할 때 텍스트가 어떻게 동작하는지를 결정합니다. 텍스트가 축소, 넘침, 또는 도형이 자동으로 크기가 조정되는지를 제어하는 데 사용합니다.

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];

    autoShape.TextFrame.TextFrameFormat.AutofitType = TextAutofitType.Shape;

    presentation.Save("autofit_type.pptx", SaveFormat.Pptx);
}

텍스트 프레임 앵커 설정

ITextFrameFormat.AnchoringType은 텍스트가 도형 내부에서 수직으로 어떻게 배치되는지를 정의합니다. 예를 들어 상단, 중간 또는 하단에 배치할 수 있습니다.

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];

    autoShape.TextFrame.TextFrameFormat.AnchoringType = TextAnchorType.Bottom;

    presentation.Save("text_anchor.pptx", SaveFormat.Pptx);
}

텍스트 탭 설정

IParagraphFormat.DefaultTabSize 및 IParagraphFormat.Tabs을 사용하여 단락 내 탭 정지를 구성합니다.

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("sample.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var paragraph = autoShape.TextFrame.Paragraphs[0];

    paragraph.ParagraphFormat.DefaultTabSize = 100;
    paragraph.ParagraphFormat.Tabs.Add(30, TabAlignment.Left);

    presentation.Save("paragraph_tabs.pptx", SaveFormat.Pptx);
}

결과:

교정 언어 설정

Aspose.Slides는 IBasePortionFormat.LanguageId를 제공하여 텍스트 구간에 대한 교정 언어를 설정할 수 있도록 합니다. 교정 언어는 PowerPoint에서 맞춤법 및 문법 검사를 수행할 때 사용되는 언어를 결정합니다.

다음 코드 예제는 텍스트 구간에 교정 언어를 설정하는 방법을 보여줍니다:

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation("presentation.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];

    var paragraph = autoShape.TextFrame.Paragraphs[0];
    paragraph.Portions.Clear();

    var font = new FontData("SimSun");

    var textPortion = new Portion();
    textPortion.PortionFormat.ComplexScriptFont = font;
    textPortion.PortionFormat.EastAsianFont = font;
    textPortion.PortionFormat.LatinFont = font;

    // 교정 언어의 Id를 설정합니다.
    textPortion.PortionFormat.LanguageId = "zh-CN";

    textPortion.Text = "1。";
    paragraph.Portions.Add(textPortion);

    presentation.Save("proofing_language.pptx", SaveFormat.Pptx);
}

기본 언어 설정

LoadOptions.DefaultTextLanguage을 사용하여 프레젠테이션을 로드하거나 만들 때 생성되는 텍스트의 기본 언어를 정의합니다.

using Aspose.Slides;

var loadOptions = new LoadOptions();
loadOptions.DefaultTextLanguage = "en-US";

using (var presentation = new Presentation(loadOptions))
{
    var slide = presentation.Slides[0];

    // 텍스트가 포함된 새 사각형 도형을 추가합니다.
    var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 150, 50);
    shape.TextFrame.Text = "Sample text";

    // 첫 번째 구간의 언어를 확인합니다.
    var portion = shape.TextFrame.Paragraphs[0].Portions[0];
    Console.WriteLine(portion.PortionFormat.LanguageId);
}

기본 텍스트 스타일 설정

프레젠테이션 수준에서 기본 텍스트 서식을 적용하려면 IPresentation.DefaultTextStyle를 사용합니다.

다음 코드 예제는 새 프레젠테이션의 모든 슬라이드에 대해 14pt 크기의 기본 굵은 글꼴을 설정하는 방법을 보여줍니다.

using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation())
{
    // 최상위 레벨 단락 형식을 가져옵니다.
    var paragraphFormat = presentation.DefaultTextStyle.GetLevel(0);

    if (paragraphFormat != null)
    {
        paragraphFormat.DefaultPortionFormat.FontHeight = 14;
        paragraphFormat.DefaultPortionFormat.FontBold = NullableBool.True;
    }

    presentation.Save("default_text_style.pptx", SaveFormat.Pptx);
}

All-Caps 효과로 텍스트 추출

PowerPoint에서 All Caps 글꼴 효과를 적용하면 원래 소문자로 입력된 텍스트라도 슬라이드에 대문자로 표시됩니다. Aspose.Slides로 해당 텍스트 구간을 가져오면 라이브러리는 입력된 그대로의 텍스트를 반환합니다. 표시된 텍스트와 일치시키려면 TextCapType을 확인하고 값이 All인 경우 반환된 문자열을 대문자로 변환합니다.

sample2.pptx 파일의 첫 번째 슬라이드에 다음과 같은 텍스트 상자가 있다고 가정합니다.

아래 코드 예제는 All Caps 효과가 적용된 텍스트를 추출하는 방법을 보여줍니다:

using Aspose.Slides;

using (var presentation = new Presentation("sample2.pptx"))
{
    var autoShape = (IAutoShape)presentation.Slides[0].Shapes[0];
    var textPortion = autoShape.TextFrame.Paragraphs[0].Portions[0];

    Console.WriteLine($"Original text: {textPortion.Text}");

    var textFormat = textPortion.PortionFormat.GetEffective();
    if (textFormat.TextCapType == TextCapType.All)
    {
        var text = textPortion.Text.ToUpper();
        Console.WriteLine($"All-Caps effect: {text}");
    }
}

출력:

Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!

FAQ

슬라이드의 표에서 텍스트를 수정하려면 어떻게 하나요?

표의 텍스트를 수정하려면 ITable을 사용하십시오. 셀을 순회하면서 각 셀을 ICell.TextFrame을 통해 업데이트하고, 단락 서식은 IParagraph.ParagraphFormat을 통해 변경합니다.

PowerPoint 슬라이드의 텍스트에 그라데이션 색을 적용하려면 어떻게 하나요?

그라데이션 색을 적용하려면 IBasePortionFormat.FillFormat를 사용합니다. IFillFormat.FillType을 FillType.Gradient으로 설정하고, 그라데이션 정지점, 방향 및 투명도를 구성합니다.