PHP를 사용하여 PowerPoint 프레젠테이션에서 SmartArt 관리

이 페이지의 내용

명확한 코드 예제를 사용하여 Java를 통한 PHP용 Aspose.Slides로 PowerPoint SmartArt를 만들고 편집하는 방법을 배우고, 슬라이드 디자인 및 자동화를 빠르게 할 수 있습니다.

개요

SmartArt는 노드, 노드 모양 및 레이아웃으로 구성된 PowerPoint 다이어그램입니다. Aspose.Slides for PHP via Java를 사용하면 SmartArt를 생성하고, 노드의 텍스트를 읽고, 레이아웃을 변경하고, 숨겨진 노드를 검사하고, 조직도 레이아웃을 구성하고, 그림 조직도를 만들 수 있습니다.

SmartArt 개체에서 텍스트 가져오기

SmartArt 노드에는 하나 이상의 도형이 포함될 수 있습니다. 노드 도형의 텍스트를 읽으려면 SmartArt::getAllNodes을 반복한 다음 SmartArtShape::getTextFrame이 반환하는 TextFrame을 읽습니다.

예제는 최소 하나의 슬라이드와 해당 슬라이드의 첫 번째 도형으로 SmartArt 개체가 포함된 프레젠테이션이 필요합니다. 사용 가능한 각 텍스트 프레임을 콘솔에 출력합니다.

use aspose\slides\Presentation;

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

    $smartArt = $slide->getShapes()->get_Item(0);
    for ($i = 0; $i < java_values($smartArt->getAllNodes()->size()); $i++) {
        $node = $smartArt->getAllNodes()->get_Item($i);
        for ($j = 0; $j < java_values($node->getShapes()->size()); $j++) {
            $nodeShape = $node->getShapes()->get_Item($j);
            if (!java_is_null($nodeShape->getTextFrame())) {
                echo $nodeShape->getTextFrame()->getText() . PHP_EOL;
            }
        }
    }
} finally {
    $presentation->dispose();
}

SmartArt 개체의 레이아웃 유형 변경

SmartArt 레이아웃은 노드가 어떻게 배치되고 연결되는지를 제어합니다. 다음 예제는 SmartArtLayoutType BasicBlockList 값을 사용하여 SmartArt 개체를 만들고, 이를 BasicProcess 값으로 변경한 뒤 프레젠테이션을 저장합니다. ShapeCollection::addSmartArt에 전달되는 위치와 크기는 포인트 단위로 측정됩니다. 레이아웃을 변경하려면 SmartArt::setLayout을 사용하십시오.

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

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

    $smartArt = $slide->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicBlockList);
    $smartArt->setLayout(SmartArtLayoutType::BasicProcess);

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

SmartArt 노드가 숨겨져 있는지 확인

SmartArtNode::isHidden는 SmartArt 데이터 모델에서 노드가 숨겨져 있는지 여부를 나타냅니다. 선택한 레이아웃이 노드를 가시적인 다이어그램 요소로 표시하지 않더라도 숨겨진 노드는 구조에 존재할 수 있습니다.

다음 예제는 SmartArtLayoutType RadialCycle 값을 사용하는 SmartArt 개체에 노드를 추가하고, 추가된 노드의 숨김 상태를 확인합니다. 노드가 숨겨져 있으면 메시지를 출력하고 다이어그램을 저장합니다.

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

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

    $smartArt = $slide->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::RadialCycle);
    $node = $smartArt->getAllNodes()->addNode();
    $isHidden = java_values($node->isHidden());

    if ($isHidden) {
        echo "The node is hidden in the SmartArt data model." . PHP_EOL;
    }

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

조직도 레이아웃 가져오기 또는 설정하기

조직도 레이아웃을 사용하는 SmartArt 다이어그램의 경우, SmartArtNode::getOrganizationChartLayout 및 SmartArtNode::setOrganizationChartLayout은 자식 노드가 부모 노드 아래에서 어떻게 배치되는지를 정의합니다. 예를 들어, 선택한 OrganizationChartLayoutType에 따라 자식 노드를 왼쪽, 오른쪽 또는 양쪽에서 매달리도록 설정할 수 있습니다.

다음 예제는 조직도를 만들고 첫 번째 노드의 레이아웃을 OrganizationChartLayoutType LeftHanging 값으로 설정합니다. 0 기반 인덱스 0은 첫 번째 최상위 노드를 선택하며, 해당 노드의 자식 노드들은 선택된 배열을 사용합니다. 수정된 프레젠테이션은 이후 저장됩니다.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SmartArtLayoutType;
use aspose\slides\OrganizationChartLayoutType;

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

    $smartArt = $slide->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::OrganizationChart);
    $rootNode = $smartArt->getNodes()->get_Item(0);
    $rootNode->setOrganizationChartLayout(OrganizationChartLayoutType::LeftHanging);

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

그림 조직도 만들기

그림 조직도는 이미지 자리 표시자를 포함하는 계층 구조 다이어그램을 위해 설계된 SmartArt 레이아웃입니다. 슬라이드에 SmartArt 개체를 추가할 때 SmartArtLayoutType PictureOrganizationChart 값을 사용하십시오. 이 예제는 이미지 자리 표시자가 포함된 다이어그램을 저장하지만, 자리 표시자를 이미지로 채우지는 않습니다.

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

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

    $smartArt = $slide->getShapes()->addSmartArt(0, 0, 400, 400, SmartArtLayoutType::PictureOrganizationChart);

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

레거시 다이어그램을 도형 그룹으로 변환

기존 프레젠테이션을 최신화할 때 PowerPoint 97–2003에서 원래 만든 조직도를 업데이트해야 할 수 있습니다. Aspose.Slides는 이러한 레거시 다이어그램을 LegacyDiagram 개체로 표현합니다. LegacyDiagram::convertToGroupShape을 사용하여 다이어그램을 도형 그룹으로 변환하면 개별 시각 요소를 편집할 수 있습니다. 자세한 내용은 LegacyDiagram API Reference를 참조하십시오.

변환은 원본 다이어그램을 제거하지 않고 도형 컬렉션에 새 그룹을 추가합니다. 변환이 성공하면 ShapeCollection::remove를 사용하여 원본을 삭제하여 중복 콘텐츠를 방지합니다. 도형 추가 및 제거가 반복을 방해하지 않도록 변환 전에 레거시 다이어그램을 리스트에 수집하십시오.

다음 예제는 프레젠테이션을 열고 모든 슬라이드를 검색한 뒤 다이어그램을 도형 그룹으로 변환하고, 업데이트된 프레젠테이션을 PPTX 형식으로 저장합니다.

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

$presentation = new Presentation("legacy-diagrams.ppt");
try {
    $legacyDiagramType = new JavaClass("com.aspose.slides.ILegacyDiagram");
    for ($i = 0; $i < java_values($presentation->getSlides()->size()); $i++) {
        $slide = $presentation->getSlides()->get_Item($i);
        $legacyDiagrams = [];
        for ($j = 0; $j < java_values($slide->getShapes()->size()); $j++) {
            $shape = $slide->getShapes()->get_Item($j);
            if (java_instanceof($shape, $legacyDiagramType)) {
                $legacyDiagrams[] = $shape;
            }
        }

        foreach ($legacyDiagrams as $legacyDiagram) {
            $groupShape = $legacyDiagram->convertToGroupShape();

            if (!java_is_null($groupShape)) {
                $slide->getShapes()->remove($legacyDiagram);
            }
        }
    }

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

저장된 프레젠테이션은 변환된 레거시 다이어그램 대신 편집 가능한 도형 그룹을 포함하며, 원본 다이어그램은 남아 있지 않습니다. PowerPoint에서 PPTX를 열어 각 그룹 내 개별 요소(텍스트, 채우기 또는 위치 등)를 편집할 수 있습니다.

FAQ

SmartArt가 RTL 언어에 대해 미러링 또는 반전을 지원합니까?

예. 선택한 SmartArt 레이아웃이 반전을 지원하는 경우, SmartArt::setReversed 메서드는 다이어그램 방향을 왼쪽에서 오른쪽으로부터 오른쪽에서 왼쪽으로(또는 그 반대로) 전환합니다.

형식 유지하면서 SmartArt를 동일 슬라이드 또는 다른 프레젠테이션으로 복사하려면 어떻게 해야 하나요?

SmartArt 도형 복제를 ShapeCollection::addClone와 함께 사용하거나, SmartArt를 포함하는 전체 슬라이드 복제를 할 수 있습니다. 두 방법 모두 크기, 위치 및 형식을 유지합니다.

SmartArt를 미리 보기 또는 웹 내보내기를 위한 래스터 이미지로 렌더링하려면 어떻게 합니까?

슬라이드 렌더링 또는 전체 프레젠테이션을 PNG 또는 JPEG로 렌더링하십시오. SmartArt는 슬라이드의 일부로 렌더링됩니다.

여러 개가 있는 경우 특정 SmartArt 개체를 슬라이드에서 어떻게 찾을 수 있나요?

Shape::setAlternativeText 또는 Shape::setName을 사용하여 SmartArt 도형에 구별되는 대체 텍스트 또는 이름을 지정하고, BaseSlide::getShapes에서 해당 값을 검색한 다음 일치하는 도형이 SmartArt인지 확인하십시오.

PHP를 사용하여 프레젠테이션에서 SmartArt 그래픽 관리