.NET에서 PowerPoint에 도형 추가하는 방법

Aspose.Slides FOSS for .NET은 프레젠테이션 슬라이드에 AutoShapes, Tables, Connectors 및 PictureFrames를 추가하는 것을 지원합니다. 모든 도형 유형은 slide.Shapes 컬렉션을 통해 추가됩니다.

단계별 가이드

단계 1: 패키지 설치

dotnet add package Aspose.Slides.Foss

설치 확인:

using Aspose.Slides.Foss;
Console.WriteLine("Ready");

2단계: 프레젠테이션 만들기

항상 Presentation를 using 문장과 함께 사용하십시오.

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

using var prs = new Presentation();
var slide = prs.Slides[0];
// ... add shapes ...
prs.Save("output.pptx", SaveFormat.Pptx);

3단계: 자동 도형 추가

slide.Shapes.AddAutoShape(shapeType, x, y, width, height)는 주어진 위치와 크기(모두 포인트)에서 도형을 배치합니다. ShapeType 상수를 사용하여 도형을 선택하십시오.

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

using var prs = new Presentation();
var slide = prs.Slides[0];

// Rectangle
var rect = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 300, 100);
rect.AddTextFrame("Rectangle shape");

// Ellipse
var ellipse = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 400, 50, 200, 100);
ellipse.AddTextFrame("Ellipse shape");

prs.Save("autoshapes.pptx", SaveFormat.Pptx);

4단계: 표 추가

slide.Shapes.AddTable(x, y, columnWidths, rowHeights)은 지정된 위치에 표를 생성합니다. 열 너비와 행 높이는 포인트 값 배열입니다.

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

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 150.0, 150.0, 150.0 };
var rowHeights = new double[] { 40.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 200, colWidths, rowHeights);

// Set header row text
string[] headers = { "Product", "Units", "Revenue" };
for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

// Set data rows
string[][] rows = {
    new[] { "Widget A", "120", "$2,400" },
    new[] { "Widget B", "85", "$1,700" },
};
for (int rowIdx = 0; rowIdx < rows.Length; rowIdx++)
    for (int col = 0; col < rows[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = rows[rowIdx][col];

prs.Save("table.pptx", SaveFormat.Pptx);

5단계: 커넥터 추가

커넥터는 두 도형을 시각적으로 연결합니다. 먼저 도형을 만든 다음, 커넥터를 추가하고 시작 및 끝 연결점을 설정합니다.

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

using var prs = new Presentation();
var slide = prs.Slides[0];

var box1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 100, 150, 60);
box1.AddTextFrame("Start");

var box2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 350, 100, 150, 60);
box2.AddTextFrame("End");

var conn = slide.Shapes.AddConnector(ShapeType.BentConnector3, 0, 0, 10, 10);
conn.StartShapeConnectedTo = box1;
conn.StartShapeConnectionSiteIndex = 3;  // right side of box1
conn.EndShapeConnectedTo = box2;
conn.EndShapeConnectionSiteIndex = 1;    // left side of box2

prs.Save("connector.pptx", SaveFormat.Pptx);

연결 사이트 인덱스는 사각형에 대해 0-3으로 번호가 매겨집니다: top=0, left=1, bottom=2, right=3.

Step 6: 그림 프레임 추가

이미지를 삽입하고 슬라이드에 PictureFrame 로 추가합니다. 먼저 이미지 바이트를 읽은 다음 프레젠테이션의 이미지 컬렉션에 추가하고, 그 후 프레임을 생성합니다.

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

using var prs = new Presentation();
byte[] imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);

var slide = prs.Slides[0];
slide.Shapes.AddPictureFrame(
    ShapeType.Rectangle,  // bounding shape type
    50, 50,               // x, y in points
    200, 150,             // width, height in points
    image
);

prs.Save("with-image.pptx", SaveFormat.Pptx);

일반적인 문제 및 해결책

슬라이드 표시 영역 밖에 도형이 나타남

슬라이드는 기본적으로 720 × 540 포인트입니다. x 또는 y 값이 해당 범위를 벗어나면 도형이 슬라이드 밖으로 배치됩니다. x < 720 및 y < 540을 유지하고, x + width <= 720 및 y + height <= 540을 보장하십시오.

NullReferenceException에 접근할 때 TextFrame

AddAutoShape()은 shape 객체를 직접 반환합니다. null을 보시면, 반환 값을 버리고 있지 않은지 확인하십시오.

테이블 셀 텍스트가 할당 후 비어 있습니다

올바른 속성은 .TextFrame.Text (셀에 직접 .Text 를 사용하지 않음) 입니다. 셀에 접근하려면 table.Rows[rowIndex][colIndex].TextFrame.Text = "value" 를 사용하십시오.

자주 묻는 질문

슬라이드에 추가할 수 있는 도형은 몇 개입니까?

라이브러리에서 강제하는 제한은 없습니다. 실용적인 제한은 파일 크기와 대상 PPTX 뷰어의 렌더링 능력에 따라 달라집니다.

추가한 후에 도형의 위치를 변경할 수 있나요?

예. AddAutoShape()에서 반환된 shape 객체는 X, Y, Width 및 Height 속성을 가지고 있으며, 이를 설정할 수 있습니다:

shape.X = 100;
shape.Y = 200;
shape.Width = 400;
shape.Height = 80;

도형 외곽선(테두리) 색상을 설정할 수 있나요?

예, shape.LineFormat을 통해:

using Aspose.Slides.Foss.Drawing;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);

차트가 지원되나요?

아니요. 차트, SmartArt 및 OLE 개체는 이 버전에서 구현되지 않았습니다.