PHP를 사용한 프레젠테이션 테이블 셀 관리

개요

Aspose.Slides를 사용하면 PowerPoint 프레젠테이션에서 테이블 셀에 접근하고 수정할 수 있습니다. 이 문서에서는 병합된 테이블 셀을 식별하는 방법, 셀 테두리를 제거하는 방법, 셀을 병합하거나 분할한 후 셀 번호를 처리하는 방법, 셀 배경 색상을 변경하는 방법, 그리고 테이블 셀 안에 이미지를 추가하는 방법을 설명합니다. 예제에서는 프레젠테이션을 생성하거나 열고, 슬라이드에서 테이블을 가져와 셀 속성을 통해 셀 서식을 업데이트하고, 수정된 프레젠테이션을 PPTX 파일로 저장하는 과정을 보여줍니다.

Aspose.Slides는 테이블 셀에 접근할 때 (열, 행) 순서의 0 기반 인덱스를 사용합니다.

병합된 테이블 셀 식별

이 예제는 기존 프레젠테이션을 열고 첫 번째 슬라이드의 첫 번째 도형을 테이블로 사용합니다. 슬라이드와 도형이 존재하며 도형이 테이블이라고 가정합니다. 그런 다음 모든 행과 열을 순회하면서 isMergedCell을 사용해 병합된 영역에 있는 셀을 식별합니다. 일치하는 셀마다 행;열 순서로 셀 좌표와 getRowSpan, getColSpan, 그리고 영역 시작 좌표인 getFirstRowIndex와 getFirstColumnIndex를 출력합니다.

use aspose\slides\Presentation;

$presentation = new Presentation("presentation_with_table.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $table = $slide->getShapes()->get_Item(0);

    $rowCount = java_values($table->getRows()->size());
    for ($rowIndex = 0; $rowIndex < $rowCount; $rowIndex++)
    {
        $columnCount = java_values($table->getColumns()->size());
        for ($columnIndex = 0; $columnIndex < $columnCount; $columnIndex++)
        {
            $cell = $table->get_Item($columnIndex, $rowIndex);
            if (java_values($cell->isMergedCell()))
            {
                printf("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.\n", $rowIndex, $columnIndex, java_values($cell->getRowSpan()), java_values($cell->getColSpan()), java_values($cell->getFirstRowIndex()), java_values($cell->getFirstColumnIndex()));
            }
        }
    }
} finally {
    $presentation->dispose();
}

테이블 셀 테두리 제거

Presentation을 생성하고 addTable을 사용해 첫 번째 슬라이드에 테이블을 추가합니다. 열 너비, 행 높이 및 테이블 위치는 포인트 단위로 지정됩니다. 예제에서는 네 개의 셀 테두리를 모두 FillType::NoFill으로 설정해 보이지 않게 만듭니다.

use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 50, 50, 50, 50 ];
    $rowHeights = [ 50, 30, 30, 30, 30 ];
    $table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);

    for ($rowIndex = 0; $rowIndex < java_values($table->getRows()->size()); $rowIndex++) {
        for ($columnIndex = 0; $columnIndex < java_values($table->getColumns()->size()); $columnIndex++) {
            $cell = $table->get_Item($columnIndex, $rowIndex);
            $cell->getCellFormat()->getBorderTop()->getFillFormat()->setFillType(FillType::NoFill);
            $cell->getCellFormat()->getBorderBottom()->getFillFormat()->setFillType(FillType::NoFill);
            $cell->getCellFormat()->getBorderLeft()->getFillFormat()->setFillType(FillType::NoFill);
            $cell->getCellFormat()->getBorderRight()->getFillFormat()->setFillType(FillType::NoFill);
        }
    }

    $presentation->save("table.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

대각선 셀 테두리 추가

getBorderDiagonalDown을 사용해 왼쪽 위 모서리에서 오른쪽 아래 모서리까지 선을 그리며, getBorderDiagonalUp을 사용해 왼쪽 아래 모서리에서 오른쪽 위 모서리까지 선을 그립니다. 대각선은 코너 헤더를 표시할 수 있으며, 두 대각선을 모두 사용하면 셀을 적용 불가능으로 표시하는 X 모양을 만들 수 있습니다.

각 대각선은 고유한 LineFormat을 가집니다. 해당 getFillFormat에서 setFillType을 사용해 FillType::Solid을 선택하고 getSolidFillColor를 통해 색을 지정합니다. 선의 두께는 setWidth로 포인트 단위에서 설정합니다.

예제에서는 하나의 행에 세 개의 셀을 만들고 각각 빨간색 하향 대각선, 파란색 상향 대각선, 그리고 두 대각선을 모두 적용합니다. 상단, 하단, 좌측, 우측 테두리는 그대로 유지됩니다.

use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 210, 210, 210 ];
    $rowHeights = [ 160 ];
    $table = $slide->getShapes()->addTable(45, 130, $columnWidths, $rowHeights);

    $downwardBorder = $table->get_Item(0, 0)->getCellFormat()->getBorderDiagonalDown();
    $downwardBorder->getFillFormat()->setFillType(FillType::Solid);
    $downwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    $downwardBorder->setWidth(3);

    $upwardBorder = $table->get_Item(1, 0)->getCellFormat()->getBorderDiagonalUp();
    $upwardBorder->getFillFormat()->setFillType(FillType::Solid);
    $upwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $upwardBorder->setWidth(5);

    $crossDownwardBorder = $table->get_Item(2, 0)->getCellFormat()->getBorderDiagonalDown();
    $crossDownwardBorder->getFillFormat()->setFillType(FillType::Solid);
    $crossDownwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    $crossDownwardBorder->setWidth(3);

    $crossUpwardBorder = $table->get_Item(2, 0)->getCellFormat()->getBorderDiagonalUp();
    $crossUpwardBorder->getFillFormat()->setFillType(FillType::Solid);
    $crossUpwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $crossUpwardBorder->setWidth(5);

    $presentation->save("diagonal_cell_borders.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

대각선은 셀 서식만 변경합니다. 각 셀은 하나의 텍스트 프레임을 유지하며, 이는 getTextFrame을 통해 접근합니다. 대각선 양쪽 영역은 독립적으로 편집할 수 없습니다.

Microsoft PowerPoint에서 렌더링된 저장된 테이블:

Three table cells showing a red diagonal from top-left to bottom-right, a blue diagonal from bottom-left to top-right, and both diagonals forming an X.

왼쪽에서 오른쪽 순서: 하향 대각선(빨강, 3 pt), 상향 대각선(파랑, 5 pt), 그리고 두 대각선이 교차하여 X 형태.

테이블 셀 병합

mergeCells을 사용해 직사각형 영역의 테이블 셀을 하나의 셀로 결합합니다. 영역의 좌측 상단 셀과 우측 하단 셀을 지정합니다. 마지막 인자는 병합이 지정된 영역 밖의 셀을 포함할 수 있는지를 제어하며, false이면 해당 영역 내부에만 병합이 제한됩니다.

예제에서는 열과 행이 70 포인트인 4×4 테이블을 만든 다음, (1, 1)부터 (2, 2)까지 네 개의 가운데 셀을 병합합니다. 결과 셀은 두 열과 두 행을 차지하지만, 테이블의 기본 그리드는 여전히 네 열과 네 행을 유지합니다. 병합된 셀의 내용이나 서식에 접근하려면 이 예제와 같이 좌측 상단 위치 $table->get_Item(1, 1)을 사용합니다. 병합 영역 외부의 셀 위치는 변경되지 않습니다.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 70, 70, 70, 70 ];
    $rowHeights = [ 70, 70, 70, 70 ];
    $table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);

    $table->mergeCells($table->get_Item(1, 1), $table->get_Item(2, 2), false);

    $presentation->save("merged_cells.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

테이블 셀 분할

앞 예제에서 셀을 병합하면 테이블 그리드가 유지됩니다. 셀을 분할하면 새로운 그리드 열이 추가되고 오른쪽에 있는 셀들의 열 인덱스가 변할 수 있습니다. Aspose.Slides는 PowerPoint의 테이블 그리드 모델을 따릅니다.

이 예제에서는 열과 행이 70 포인트인 4×4 테이블을 만든 뒤 셀 (1, 1)에 대해 splitByWidth를 호출합니다. 셀의 70 포인트 너비 중 절반을 전달해 두 개의 동일 폭 셀을 생성합니다.

분할 후 두 절반은 $table->get_Item(1, 1)와 $table->get_Item(2, 1)으로 접근합니다. 테이블 그리드는 이제 다섯 열을 갖게 되며, 원래 열 2와 3에 있던 셀은 각각 열 3과 4로 이동합니다. 행 인덱스는 변하지 않습니다. 분할 후 셀에 접근할 때는 업데이트된 열 인덱스를 사용하십시오.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 70, 70, 70, 70 ];
    $rowHeights = [ 70, 70, 70, 70 ];
    $table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);

    $table->get_Item(1, 1)->splitByWidth(java_values($table->get_Item(1, 1)->getWidth()) / 2);

    $presentation->save("split_cells.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

An unmerged 70-point cell splits into two 35-point cells, adding a fifth grid column and shifting the indices to its right.

너비 분할은 셀 (1, 1)에 적용되며, 0 기반 (열, 행) 인덱스를 사용합니다. 다른 행은 두 새로운 열 위치를 모두 차지하는 셀을 유지합니다.

행 또는 열 Span을 기준으로 병합된 셀 분할

병합된 템플릿 셀을 데이터 입력용으로 준비하려면 splitByRowSpan을 사용해 기존 행 경계 따라 분할하거나, splitByColSpan을 사용해 열 경계 따라 분할합니다.

index 인자는 분할된 상단(또는 좌측) 부분의 행 또는 열 수를 나타내며, 병합된 영역을 기준으로 합니다:

예제는 프레젠테이션에 첫 번째 슬라이드 첫 번째 도형으로 테이블이 존재하고, (1, 2)와 (1, 3)이 수직으로 병합되어 있다고 가정합니다. 아래쪽 위치에서 시작해 getFirstColumnIndex와 getFirstRowIndex를 사용해 원점을 찾고 두 스팬을 확인합니다. splitByRowSpan(1)을 호출하면 제품명용으로 행 2와 3을 분리합니다. 가로 두 열 병합인 경우 대신 splitByColSpan(1)을 사용합니다.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("table_template.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $table = $slide->getShapes()->get_Item(0);

    $selectedCell = $table->get_Item(1, 3);
    $firstColumnIndex = java_values($selectedCell->getFirstColumnIndex());
    $firstRowIndex = java_values($selectedCell->getFirstRowIndex());
    $mergedCell = $table->get_Item($firstColumnIndex, $firstRowIndex);

    if (java_values($mergedCell->isMergedCell()) && java_values($mergedCell->getRowSpan()) == 2 && java_values($mergedCell->getColSpan()) == 1)
    {
        $mergedCell->splitByRowSpan(1);

        // 분할 후 테이블에서 결과 셀을 가져옵니다.
        $upperCell = $table->get_Item($firstColumnIndex, $firstRowIndex);
        $lowerCell = $table->get_Item($firstColumnIndex, $firstRowIndex + 1);
        echo "Upper cell merged: " . (java_values($upperCell->isMergedCell()) ? "true" : "false") . PHP_EOL;
        echo "Lower cell merged: " . (java_values($lowerCell->isMergedCell()) ? "true" : "false") . PHP_EOL;

        $upperCell->getTextFrame()->setText("Product A");
        $lowerCell->getTextFrame()->setText("Product B");

        $presentation->save("split_template.pptx", SaveFormat::Pptx);
    }
    else
    {
        echo "Select a merged region spanning exactly two rows and one column." . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

테이블 그리드와 주변 셀 인덱스는 변하지 않습니다. 결과 셀을 좌표로 검색하면 두 셀 모두 Span이 1이며 isMergedCell은 false를 반환합니다. 하나의 분할 후에도 큰 영역이 부분적으로 병합된 상태로 남을 수 있습니다.

원본 텍스트와 서식은 상단(또는 좌측) 셀에 남고, 새로운 셀은 비어 있지만 채우기, 테두리, 여백과 같은 셀 서식을 상속합니다. 분할 후 셀에 데이터를 채우고 필요한 텍스트 서식을 명시적으로 설정하십시오.

저장된 프레젠테이션에는 템플릿 셀 서식이 유지된 채 “Product A"와 “Product B” 셀 각각이 별도로 표시됩니다. 자세한 내용은 Cell API Reference를 참고하십시오.

특정 높이로 셀 분할

splitByHeight은 위쪽 부분의 높이를 포인트 단위로 받습니다. splitByRowSpan은 위쪽 부분에 해당하는 기존 그리드 행 수를 받습니다. 오른쪽 열에 40 포인트 셀을 가운데 배치하려면 셀 실제 높이에서 40을 빼고 남은 공간을 위아래에 동일하게 나눕니다.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 160, 160 ];
    $rowHeights = [ 140 ];
    
    $table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);
    $table->get_Item(0, 0)->getTextFrame()->setText("Left");

    $rightCell = $table->get_Item(1, 0);
    $height = java_values($rightCell->getHeight());
    $margin = ($height - 40) / 2;

    $rightCell->splitByHeight($margin);
    $table->get_Item(1, 1)->splitByHeight(40);
    $table->get_Item(1, 1)->getTextFrame()->setText("Middle");

    $presentation->save("split_by_height.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

첫 번째 분할은 그리드 행을 하나 추가하고 셀 (1, 1) 아래쪽에 90 포인트를 남깁니다. 두 번째 분할은 해당 셀을 40 포인트 중간 셀과 50 포인트 하단 셀로 나눕니다. 오른쪽 열은 이제 위에서 아래 순서대로 높이가 50, 40, 50 포인트인 세 개의 셀을 갖게 됩니다. 왼쪽 셀은 세 행을 모두 차지하며 원래 높이인 140 포인트를 유지합니다.

The left cell spans the full table height beside three cells with Middle in the center.

테이블 셀 배경 색상 변경

이 예제는 열이 150 포인트, 행이 50 포인트인 테이블을 생성합니다. setFillType을 사용해 단색 채우기를 선택하고, getSolidFillColor이 반환하는 색을 빨간색으로 설정하여 셀 (2, 3)(3번째 열, 4번째 행)의 배경을 변경합니다.

use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 150, 150, 150, 150 ];
    $rowHeights = [ 50, 50, 50, 50, 50 ];
    $table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);

    $cell = $table->get_Item(2, 3);
    $cell->getCellFormat()->getFillFormat()->setFillType(FillType::Solid);
    $cell->getCellFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);

    $presentation->save("cell_background_color.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

테이블 셀 안에 이미지 추가

예제를 실행하기 전에 입력 이미지를 작업 디렉터리에 배치하십시오. 이미지는 Images::fromFile으로 로드하고, addImage를 사용해 프레젠테이션의 이미지 컬렉션에 추가합니다. 그런 다음 이미지를 셀 (0, 0)(테이블의 첫 번째 셀)의 그림 채우기로 지정합니다.

PictureFillMode::Stretch는 이미지를 셀 전체에 맞게 늘리며, 이 과정에서 가로세로 비율이 변할 수 있습니다. 열 너비와 행 높이는 포인트 단위입니다. 로드된 이미지는 프레젠테이션에 추가된 후 finally 블록에서 해제됩니다.

use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\PictureFillMode;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $columnWidths = [ 150, 150, 150, 150 ];
    $rowHeights = [ 100, 100, 100, 100, 90 ];
    $table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);

    $image = Images::fromFile("aspose_logo.jpg");
    try {
        $ppImage = $presentation->getImages()->addImage($image);
    } finally {
        $image->dispose();
    }

    $table->get_Item(0, 0)->getCellFormat()->getFillFormat()->setFillType(FillType::Picture);
    $table->get_Item(0, 0)->getCellFormat()->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode::Stretch);
    $table->get_Item(0, 0)->getCellFormat()->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($ppImage);

    $presentation->save("table_cell_with_image.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

FAQ

단일 셀의 서로 다른 면에 대해 선 두께와 스타일을 다르게 지정할 수 있나요?

네. top, bottom, left, right 테두리는 각각 별도 속성을 가지므로 각 면의 두께와 스타일을 다르게 지정할 수 있습니다.

셀 배경에 그림을 설정한 후 열/행 크기를 변경하면 이미지가 어떻게 되나요?

동작은 fill mode(stretch/tile)에 따라 달라집니다. stretch 모드에서는 이미지가 새로운 셀 크기에 맞게 조정되고, tile 모드에서는 타일이 다시 계산됩니다.

셀 전체 내용에 하이퍼링크를 지정할 수 있나요?

Hyperlinks는 셀 텍스트 프레임 내부의 텍스트(포션) 수준이나 전체 테이블/도형 수준에서 설정됩니다. 실무에서는 셀 내의 전체 텍스트 또는 특정 포션에 링크를 할당합니다.

단일 셀 안에서 서로 다른 글꼴을 사용할 수 있나요?

네. 셀의 텍스트 프레임은 portions(런) 별로 독립적인 서식을 지원하므로 글꼴 종류, 스타일, 크기 및 색상을 각각 지정할 수 있습니다.