.NET에서 프레젠테이션 표 관리

이 페이지의 내용

Aspose.Slides for .NET를 사용하여 PowerPoint 슬라이드에서 표를 만들고 편집합니다. 표 작업 흐름을 간소화하는 간단한 C# 코드 예제를 확인하세요.

소개

PowerPoint의 표는 정보를 표시하고 전달하는 효율적인 방법입니다. 행과 열로 배열된 셀 그리드에 있는 정보는 직관적이며 이해하기 쉽습니다.

Aspose.Slides는 Table 클래스, ITable 인터페이스, Cell 클래스, ICell 인터페이스 및 기타 유형을 제공하여 다양한 프레젠테이션에서 표를 만들고, 업데이트하고, 관리할 수 있게 합니다.

원본부터 표 만들기

1. Presentation 클래스의 인스턴스를 생성합니다.
2. 인덱스를 통해 슬라이드 참조를 가져옵니다.
3. columnWidth 배열을 정의합니다.
4. rowHeight 배열을 정의합니다.
5. AddTable 메서드를 사용하여 슬라이드에 ITable 객체를 추가합니다.
6. 각 ICell을 순회하면서 상, 하, 좌, 우 테두리 서식을 적용합니다.
7. 표 첫 번째 행의 처음 두 셀을 병합합니다.
8. ICell의 [TextFrame]에 접근합니다.
9. TextFrame에 텍스트를 추가합니다.
10. 수정된 프레젠테이션을 저장합니다.

이 C# 코드는 프레젠테이션에 표를 만드는 방법을 보여줍니다:

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

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

// 첫 번째 슬라이드에 접근합니다
ISlide sld = pres.Slides[0];

// 열의 너비와 행의 높이를 정의합니다
double[] dblCols = { 50, 50, 50 };
double[] dblRows = { 50, 30, 30, 30, 30 };

// 슬라이드에 표 형태를 추가합니다
ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

// 각 셀의 테두리 형식을 설정합니다
for (int row = 0; row < tbl.Rows.Count; row++)
{
	for (int cell = 0; cell < tbl.Rows[row].Count; cell++)
	{
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderTop.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.FillType = (FillType.Solid);
		tbl.Rows[row][cell].CellFormat.BorderBottom.FillFormat.SolidFillColor.Color= Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderBottom.Width =5;

		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderLeft.FillFormat.SolidFillColor.Color =Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderLeft.Width = 5;

		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
		tbl.Rows[row][cell].CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
		tbl.Rows[row][cell].CellFormat.BorderRight.Width = 5;
	}
}
// 행 1의 셀 1과 2를 병합합니다
tbl.MergeCells(tbl.Rows[0][0], tbl.Rows[0][1], false);

// 병합된 셀에 텍스트를 추가합니다
tbl.Rows[0][0].TextFrame.Text = "Merged Cells";

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

표준 표에서 번호 매기기

표준 표에서 셀 번호 매기기는 직관적이며 0부터 시작합니다. 표의 첫 번째 셀은 0,0(열 0, 행 0)으로 인덱싱됩니다.

예를 들어, 4열 4행 표의 셀은 다음과 같이 번호가 매겨집니다:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

이 C# 코드는 위에서 번호가 매겨진 표준 4 × 4 표를 생성하고 각 셀의 테두리 서식을 설정합니다:

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

// PPTX 파일을 나타내는 Presentation 클래스를 인스턴스화합니다
using (Presentation pres = new Presentation())
{

    // 첫 번째 슬라이드에 접근합니다
    ISlide sld = pres.Slides[0];

    // 열의 너비와 행의 높이를 정의합니다
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // 슬라이드에 표 형태를 추가합니다
    ITable tbl = sld.Shapes.AddTable(100, 50, dblCols, dblRows);

    // 각 셀에 대한 테두리 형식을 설정합니다
    foreach (IRow row in tbl.Rows)
    {
        foreach (ICell cell in row)
        {
			cell.CellFormat.BorderTop.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderTop.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderTop.Width = 5;

			cell.CellFormat.BorderBottom.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderBottom.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderBottom.Width = 5;

			cell.CellFormat.BorderLeft.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderLeft.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderLeft.Width = 5;

			cell.CellFormat.BorderRight.FillFormat.FillType = FillType.Solid;
			cell.CellFormat.BorderRight.FillFormat.SolidFillColor.Color = Color.Red;
			cell.CellFormat.BorderRight.Width = 5;
        }
    }

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

기존 표에 접근하기

1. Presentation 클래스의 인스턴스를 생성합니다.

2. 인덱스를 통해 표가 포함된 슬라이드에 대한 참조를 가져옵니다.

3. ITable 객체를 생성하고 null로 설정합니다.

4. 표가 발견될 때까지 모든 IShape 객체를 순회합니다.

   슬라이드에 단일 표만 포함되어 있다고 생각되는 경우, 해당 슬라이드가 가진 모든 도형을 확인하면 됩니다. 도형이 표로 식별되면 이를 Table 객체로 타입 캐스팅할 수 있습니다. 그러나 슬라이드에 여러 표가 포함되어 있는 경우, 원하는 표를 AlternativeText를 통해 검색하는 것이 좋습니다.

5. ITable 객체를 사용하여 표를 작업합니다. 아래 예제에서는 표에 새 행을 추가했습니다.

6. 수정된 프레젠테이션을 저장합니다.

이 C# 코드는 기존 표에 접근하고 작업하는 방법을 보여줍니다:

using Aspose.Slides;

// PPTX 파일을 나타내는 Presentation 클래스를 인스턴스화합니다
using (Presentation pres = new Presentation("UpdateExistingTable.pptx"))
{

    // 첫 번째 슬라이드에 접근합니다
    ISlide sld = pres.Slides[0];

    // null TableEx를 초기화합니다
    ITable tbl = null;

    // 도형들을 순회하며 찾은 표에 대한 참조를 설정합니다
    foreach (IShape shp in sld.Shapes)
        if (shp is ITable)
            tbl = (ITable)shp;

    // 두 번째 행의 첫 번째 열에 텍스트를 설정합니다
    tbl[0, 1].TextFrame.Text = "New";

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

텍스트 프레임을 소유한 셀 찾기

표에서 ITextFrame을 받는 일반 텍스트 처리 코드에서는 ITextFrame.ParentCell 속성을 사용하여 해당 [ICell]을 검색합니다. 표 셀 텍스트 프레임의 경우, ITextFrame.ParentCell은 설정되어 있고 ITextFrame.ParentShape은 null이며, 표 자체는 도형이라는 점에 유의하십시오.

셀 좌표는 읽기 전용 ICell.FirstColumnIndex와 ICell.FirstRowIndex 속성을 통해 얻을 수 있습니다. ITextFrame.ParentCell도 읽기 전용이며, 소유자를 탐색할 수 있게 해 주지만 소유권을 변경하지는 않습니다. 사용하기 전에 항상 반환된 셀이 null인지 확인하십시오.

표 셀 및 도형 소유자를 식별하는 완전한 예제(스마트아트 노드와 연결된 도형 포함)는 Search and Replace Text를 참고하세요.

표 안의 텍스트 정렬

1. Presentation 클래스의 인스턴스를 생성합니다.
2. 인덱스를 통해 슬라이드 참조를 가져옵니다.
3. 슬라이드에 ITable 객체를 추가합니다.
4. 표에서 ITextFrame 객체에 접근합니다.
5. ITextFrame의 IParagraph에 접근합니다.
6. 텍스트를 수직으로 정렬합니다.
7. 수정된 프레젠테이션을 저장합니다.

이 C# 코드는 표 안의 텍스트를 정렬하는 방법을 보여줍니다:

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

// Presentation 클래스를 인스턴스화합니다
Presentation presentation = new Presentation();

// 첫 번째 슬라이드를 가져옵니다
ISlide slide = presentation.Slides[0];

// 열 너비와 행 높이를 정의합니다
double[] dblCols = { 120, 120, 120, 120 };
double[] dblRows = { 100, 100, 100, 100 };

// 슬라이드에 표 형태를 추가합니다
ITable tbl = slide.Shapes.AddTable(100, 50, dblCols, dblRows);
tbl[1, 0].TextFrame.Text = "10";
tbl[2, 0].TextFrame.Text = "20";
tbl[3, 0].TextFrame.Text = "30";

// Accesses the text frame
ITextFrame txtFrame = tbl[0, 0].TextFrame;

// Creates the Paragraph object for the text frame
IParagraph paragraph = txtFrame.Paragraphs[0];

// Creates the Portion object for paragraph
IPortion portion = paragraph.Portions[0];
portion.Text = "Text here";
portion.PortionFormat.FillFormat.FillType = FillType.Solid;
portion.PortionFormat.FillFormat.SolidFillColor.Color = Color.Black;

// 텍스트를 수직으로 정렬합니다
ICell cell = tbl[0, 0];
cell.TextAnchorType = TextAnchorType.Center;
cell.TextVerticalType = TextVerticalType.Vertical270;

// 프레젠테이션을 디스크에 저장합니다
presentation.Save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);

표 수준에서 텍스트 서식 설정

1. Presentation 클래스의 인스턴스를 생성합니다.
2. 인덱스를 통해 슬라이드 참조를 가져옵니다.
3. 슬라이드에서 ITable 객체에 접근합니다.
4. 텍스트의 [FontHeight]를 설정합니다.
5. [Alignment]와 [MarginRight]를 설정합니다.
6. [TextVerticalType]을 설정합니다.
7. 수정된 프레젠테이션을 저장합니다.

이 C# 코드는 표 안의 텍스트에 원하는 서식 옵션을 적용하는 방법을 보여줍니다:

using Aspose.Slides;

// Presentation 클래스의 인스턴스를 생성합니다
Presentation presentation = new Presentation();
ISlide slide = presentation.Slides[0];

ITable someTable = presentation.Slides[0].Shapes[0] as ITable; // 첫 번째 슬라이드의 첫 번째 도형이 표라고 가정합니다

// 표 셀의 글꼴 높이를 설정합니다
PortionFormat portionFormat = new PortionFormat();
portionFormat.FontHeight = 25;
someTable.SetTextFormat(portionFormat);

// 표 셀의 텍스트 정렬 및 오른쪽 여백을 한 번에 설정합니다
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.Alignment = TextAlignment.Right;
paragraphFormat.MarginRight = 20;
someTable.SetTextFormat(paragraphFormat);

// 표 셀의 텍스트 수직 유형을 설정합니다
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.TextVerticalType = TextVerticalType.Vertical;
someTable.SetTextFormat(textFrameFormat);


presentation.Save("result.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

표 스타일 속성 가져오기

Aspose.Slides를 사용하면 표의 스타일 속성을 검색하여 다른 표나 다른 위치에 재사용할 수 있습니다. 이 C# 코드는 표 프리셋 스타일에서 스타일 속성을 가져오는 방법을 보여줍니다:

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

using (Presentation pres = new Presentation())
{
    ITable table = pres.Slides[0].Shapes.AddTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.StylePreset = TableStylePreset.DarkStyle1; // 기본 스타일 프리셋 테마를 변경합니다

    // 표의 스타일 프리셋을 가져옵니다.
    TableStylePreset stylePreset = table.StylePreset;
    Console.WriteLine($"Table style preset: {stylePreset}");

    // 검색된 스타일 프리셋을 다른 표에 적용합니다.
    ITable anotherTable = pres.Slides[0].Shapes.AddTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    anotherTable.StylePreset = stylePreset;

    pres.Save("table.pptx", SaveFormat.Pptx);
}

표의 가로세로 비율 잠그기

기하학적 도형의 가로세로 비율은 서로 다른 차원에서의 크기 비율을 의미합니다. Aspose.Slides는 AspectRatioLocked 속성을 제공하여 표 및 기타 도형의 가로세로 비율 잠금 설정을 할 수 있게 합니다.

이 C# 코드는 표의 가로세로 비율을 잠그는 방법을 보여줍니다:

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

using (Presentation pres = new Presentation("pres.pptx"))
{
    ITable table = (ITable)pres.Slides[0].Shapes[0];
    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    table.ShapeLock.AspectRatioLocked = !table.ShapeLock.AspectRatioLocked; // 반전

    Console.WriteLine($"Lock aspect ratio set: {table.ShapeLock.AspectRatioLocked}");

    pres.Save("pres-out.pptx", SaveFormat.Pptx);
}

FAQ

전체 표와 셀 내 텍스트에 대해 오른쪽‑왼쪽(RTL) 읽기 방향을 활성화할 수 있나요?

예. 표는 RightToLeft 속성을 제공하며, 단락은 ParagraphFormat.RightToLeft 속성을 가집니다. 두 속성을 모두 설정하면 셀 내부에서 올바른 RTL 순서와 렌더링이 보장됩니다.

최종 파일에서 사용자가 표를 이동하거나 크기를 조절하지 못하도록 방지하려면 어떻게 해야 하나요?

shape locks를 사용하여 이동, 크기 조절, 선택 등을 비활성화하십시오. 이러한 잠금은 표에도 적용됩니다.

셀 안에 이미지를 배경으로 삽입하는 것이 지원되나요?

예. 셀에 picture fill을 설정하면 이미지가 선택한 모드(스트레치 또는 타일)에 따라 셀 영역을 덮습니다.