.NET에서 프레젠테이션 텍스트 상자 관리

소개

슬라이드의 텍스트는 일반적으로 텍스트 상자나 도형에 존재합니다. 따라서 슬라이드에 텍스트를 추가하려면 먼저 텍스트 상자를 추가한 다음 텍스트 상자 안에 텍스트를 넣어야 합니다.

텍스트를 포함할 수 있는 도형을 추가할 수 있도록 Aspose.Slides for .NET은 IAutoShape 인터페이스를 제공합니다.

Note

Aspose.Slides는 또한 슬라이드에 도형을 추가할 수 있도록 IShape 인터페이스를 제공합니다. 그러나 IShape 인터페이스를 통해 추가된 모든 도형이 텍스트를 포함할 수 있는 것은 아닙니다. IAutoShape 인터페이스를 통해 추가된 도형은 일반적으로 텍스트를 포함합니다.

따라서 텍스트를 추가하려는 기존 도형을 다룰 때, 해당 도형이 IAutoShape 인터페이스로 캐스팅되었는지 확인하고 확인하고 싶을 수 있습니다. 그래야만 IAutoShape 아래의 속성인 TextFrame을 사용할 수 있습니다. 이 페이지의 Update Text 섹션을 참고하십시오.

슬라이드에 텍스트 상자 만들기

Presentation 클래스의 인스턴스를 생성합니다.
인덱스를 통해 첫 번째 슬라이드의 참조를 가져옵니다.
IAutoShape 객체를 추가하고, 슬라이드의 지정된 위치에 ShapeType을 Rectangle 로 설정한 다음 새로 추가된 IAutoShape 객체에 대한 참조를 얻습니다.
텍스트를 포함할 IAutoShape 객체에 TextFrame 속성을 추가합니다. 아래 예시에서는 다음 텍스트를 추가했습니다: Aspose TextBox
마지막으로 Presentation 객체를 통해 PPTX 파일을 저장합니다.

다음 C# 코드는 위 단계들의 구현으로, 슬라이드에 텍스트를 추가하는 방법을 보여줍니다:

    // PresentationEx를 인스턴스화합니다
    using (Presentation pres = new Presentation())
    {

        // 프레젠테이션의 첫 번째 슬라이드를 가져옵니다
        ISlide sld = pres.Slides[0];

        // 타입을 Rectangle로 설정한 AutoShape를 추가합니다
        IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);

        // Rectangle에 TextFrame을 추가합니다
        ashp.AddTextFrame(" ");

        // 텍스트 프레임에 접근합니다
        ITextFrame txtFrame = ashp.TextFrame;

        // 텍스트 프레임용 Paragraph 객체를 생성합니다
        IParagraph para = txtFrame.Paragraphs[0];

        // Paragraph용 Portion 객체를 생성합니다
        IPortion portion = para.Portions[0];

        // 텍스트를 설정합니다
        portion.Text = "Aspose TextBox";

        // 프레젠테이션을 디스크에 저장합니다
        pres.Save("TextBox_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
    }

텍스트 상자 도형 확인

Aspose.Slides는 IAutoShape 인터페이스의 IsTextBox 속성을 제공하여 도형을 검사하고 텍스트 상자를 식별할 수 있게 합니다.

텍스트 상자와 도형

다음 C# 코드는 도형이 텍스트 상자로 생성되었는지 확인하는 방법을 보여줍니다:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    Aspose.Slides.LowCode.ForEach.Shape(presentation, (shape, slide, index) =>
    {
        if (shape is IAutoShape autoShape)
        {
            Console.WriteLine(autoShape.IsTextBox ? "shape is a text box" : "shape is not a text box");
        }
    });
}

AddAutoShape 메서드를 사용하여 IShapeCollection 인터페이스에서 자동 도형을 단순히 추가하면, 해당 자동 도형의 IsTextBox 속성은 false를 반환합니다. 그러나 AddTextFrame 메서드나 Text 속성을 사용하여 자동 도형에 텍스트를 추가하면 IsTextBox 속성은 true를 반환합니다.

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

    IAutoShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
    // shape1.IsTextBox는 false입니다
    shape1.AddTextFrame("shape 1");
    // shape1.IsTextBox는 true입니다

    IAutoShape shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
    // shape2.IsTextBox는 false입니다
    shape2.TextFrame.Text = "shape 2";
    // shape2.IsTextBox는 true입니다

    IAutoShape shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
    // shape3.IsTextBox는 false입니다
    shape3.AddTextFrame("");
    // shape3.IsTextBox는 false입니다

    IAutoShape shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
    // shape4.IsTextBox는 false입니다
    shape4.TextFrame.Text = "";
    // shape4.IsTextBox는 false입니다
}

텍스트 상자에 열 추가

Aspose.Slides는 텍스트 상자에 열을 추가할 수 있도록 ColumnCount 및 ColumnSpacing 속성(ITextFrameFormat 인터페이스와 TextFrameFormat 클래스에서 제공)을 제공합니다. 텍스트 상자의 열 수를 지정하고 열 사이의 간격을 포인트 단위로 지정할 수 있습니다.

다음 C# 코드는 설명된 작업을 보여줍니다:

using (Presentation presentation = new Presentation())
{
	// 프레젠테이션에서 첫 번째 슬라이드를 가져옵니다
	ISlide slide = presentation.Slides[0];

	// 타입을 Rectangle로 설정한 AutoShape를 추가합니다
	IAutoShape aShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

	// Rectangle에 TextFrame을 추가합니다
	aShape.AddTextFrame("All these columns are limited to be within a single text container -- " +
	"you can add or delete text and the new or remaining text automatically adjusts " +
	"itself to flow within the container. You cannot have text flow from one container " +
	"to other though -- we told you PowerPoint's column options for text are limited!");

	// TextFrame의 텍스트 형식을 가져옵니다
	ITextFrameFormat format = aShape.TextFrame.TextFrameFormat;

	// TextFrame의 열 수를 지정합니다
	format.ColumnCount = 3;

	// 열 사이의 간격을 지정합니다
	format.ColumnSpacing = 10;

	// 프레젠테이션을 저장합니다
	presentation.Save("ColumnCount.pptx", SaveFormat.Pptx);
}

텍스트 프레임에 열 추가

Aspose.Slides for .NET은 텍스트 프레임에 열을 추가할 수 있는 ColumnCount 속성(ITextFrameFormat 인터페이스)을 제공합니다. 이 속성을 통해 텍스트 프레임에 원하는 열 수를 지정할 수 있습니다.

다음 C# 코드는 텍스트 프레임 안에 열을 추가하는 방법을 보여줍니다:

string outPptxFileName = "ColumnsTest.pptx";
using (Presentation pres = new Presentation())
{
    IAutoShape shape1 = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.TextFrame.TextFrameFormat;

    format.ColumnCount = 2;
    shape1.TextFrame.Text = "All these columns are forced to stay within a single text container -- " +
                                "you can add or delete text - and the new or remaining text automatically adjusts " +
                                "itself to stay within the container. You cannot have text spill over from one container " +
                                "to other, though -- because PowerPoint's column options for text are limited!";
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(double.NaN == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnSpacing = 20;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(20 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnCount = 3;
    format.ColumnSpacing = 15;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(3 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(15 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }
}

텍스트 업데이트

Aspose.Slides를 사용하면 텍스트 상자에 포함된 텍스트나 프레젠테이션에 포함된 모든 텍스트를 변경하거나 업데이트할 수 있습니다.

다음 C# 코드는 프레젠테이션의 모든 텍스트를 업데이트하거나 변경하는 작업을 보여줍니다:

using(Presentation pres = new Presentation("text.pptx"))
{
   foreach (ISlide slide in pres.Slides)
   {
       foreach (IShape shape in slide.Shapes)
       {
           if (shape is IAutoShape autoShape) //형상이 텍스트 프레임(IAutoShape)을 지원하는지 확인합니다. 
           {
              foreach (IParagraph paragraph in autoShape.TextFrame.Paragraphs) //텍스트 프레임의 단락을 순회합니다
               {
                   foreach (IPortion portion in paragraph.Portions) //단락의 각 부분을 순회합니다
                   {
                       portion.Text = portion.Text.Replace("years", "months"); //텍스트를 변경합니다
                       portion.PortionFormat.FontBold = NullableBool.True; //형식을 변경합니다
                   }
               }
           }
       }
   }
  
   //수정된 프레젠테이션을 저장합니다
   pres.Save("text-changed.pptx", SaveFormat.Pptx);
}

하이퍼링크가 있는 텍스트 상자 추가

텍스트 상자 안에 링크를 삽입할 수 있습니다. 텍스트 상자를 클릭하면 사용자는 해당 링크를 열게 됩니다.

Presentation 클래스의 인스턴스를 생성합니다.
인덱스를 통해 첫 번째 슬라이드의 참조를 가져옵니다.
ShapeType을 Rectangle로 설정한 AutoShape 객체를 슬라이드의 지정된 위치에 추가하고, 새로 추가된 AutoShape 객체에 대한 참조를 얻습니다.
AutoShape 객체에 기본 텍스트로 Aspose TextBox를 포함하는 TextFrame을 추가합니다.
IHyperlinkManager 클래스를 인스턴스화합니다.
IHyperlinkManager 객체를 TextFrame의 원하는 부분에 연결된 HyperlinkClick 속성에 할당합니다.
마지막으로 Presentation 객체를 통해 PPTX 파일을 저장합니다.

다음 C# 코드는 위 단계들의 구현으로, 슬라이드에 하이퍼링크가 있는 텍스트 상자를 추가하는 방법을 보여줍니다:

// PPTX를 나타내는 Presentation 클래스를 인스턴스화합니다
Presentation pptxPresentation = new Presentation();

// 프레젠테이션의 첫 번째 슬라이드를 가져옵니다
ISlide slide = pptxPresentation.Slides[0];

// 타입을 Rectangle로 설정한 AutoShape 객체를 추가합니다
IShape pptxShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

// 도형을 AutoShape로 캐스팅합니다
IAutoShape pptxAutoShape = (IAutoShape)pptxShape;

// AutoShape와 연결된 ITextFrame 속성에 접근합니다
pptxAutoShape.AddTextFrame("");

ITextFrame ITextFrame = pptxAutoShape.TextFrame;

// 프레임에 텍스트를 추가합니다
ITextFrame.Paragraphs[0].Portions[0].Text = "Aspose.Slides";

// 포션 텍스트에 하이퍼링크를 설정합니다
IHyperlinkManager HypMan = ITextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkManager;
HypMan.SetExternalHyperlinkClick("http://www.aspose.com");

// PPTX 프레젠테이션을 저장합니다
pptxPresentation.Save("hLinkPPTX_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

FAQ

마스터 슬라이드 작업 시 텍스트 상자와 텍스트 자리표시자(placeholder)의 차이점은 무엇인가요?

A placeholder 은 master 로부터 스타일/위치를 상속받으며 layouts 에서 재정의할 수 있습니다. 반면 일반 텍스트 상자는 특정 슬라이드에 독립적인 객체이며 레이아웃을 전환해도 변하지 않습니다.

차트, 테이블 및 SmartArt 내부 텍스트를 건드리지 않고 프레젠테이션 전체에서 대량 텍스트 교체를 수행하려면 어떻게 해야 하나요?

텍스트 프레임이 있는 자동 도형만 반복하고, 포함된 객체(charts, tables, SmartArt)는 별도로 컬렉션을 탐색하거나 해당 객체 유형을 건너뛰어 제외합니다.

.NET에서 프레젠테이션 자리표시자 관리 .NET에서 AutoFit을 활용해 프레젠테이션을 향상시키세요