مدیریت SmartArt در ارائه‌های PowerPoint با استفاده از Java

نمای کلی

SmartArt یک نمودار PowerPoint است که از گره‌ها، شکل‌های گره و یک طرح ساخته شده است. با Aspose.Slides برای Java می‌توانید SmartArt ایجاد کنید، متن را از گره‌های آن بخوانید، طرح آن را تغییر دهید، گره‌های مخفی را بررسی کنید، طرح‌های نمودار سازمانی را پیکربندی کنید و نمودارهای سازمانی تصویری ایجاد کنید.

دریافت متن از یک شیء SmartArt

یک گره SmartArt می‌تواند یک یا چند شکل داشته باشد. برای خواندن متن از شکل‌های گره، باید از ISmartArt.getAllNodes عبور کنید، سپس ITextFrame بازگردانده شده توسط ISmartArtShape.getTextFrame را بخوانید.

این مثال به یک ارائه حداقل با یک اسلاید و یک شیء SmartArt به عنوان اولین شکل در آن اسلاید نیاز دارد. این برنامه هر چارچوب متنی موجود را به کنسول چاپ می‌کند.

import com.aspose.slides.*;

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

    ISmartArt smartArt = (ISmartArt) slide.getShapes().get_Item(0);
    for (ISmartArtNode node : smartArt.getAllNodes()) {
        for (ISmartArtShape nodeShape : node.getShapes()) {
            if (nodeShape.getTextFrame() != null) {
                System.out.println(nodeShape.getTextFrame().getText());
            }
        }
    }
} finally {
    presentation.dispose();
}

تغییر نوع طرح یک شیء SmartArt

طرح SmartArt تعیین می‌کند گره‌ها چگونه چیده و به هم وصل شوند. مثال زیر یک شیء SmartArt را با مقدار BasicBlockList از SmartArtLayoutType ایجاد می‌کند، آن را به مقدار BasicProcess تغییر می‌دهد و ارائه را ذخیره می‌کند. موقعیت و اندازه‌ای که به IShapeCollection.addSmartArt پاس داده می‌شود بر حسب نقاط اندازه‌گیری می‌شود. برای تغییر طرح از ISmartArt.setLayout استفاده کنید.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
    smartArt.setLayout(SmartArtLayoutType.BasicProcess);

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

بررسی اینکه آیا گره SmartArt مخفی است

ISmartArtNode.isHidden نشان می‌دهد آیا گره در مدل داده‌های SmartArt مخفی است یا نه. گره‌های مخفی می‌توانند در ساختار وجود داشته باشند حتی زمانی که طرح انتخاب شده آن‌ها را به‌عنوان عناصر قابل‌دید نمودار نمایش نمی‌دهد.

مثال زیر یک گره به شیء SmartArt که از مقدار RadialCycle از SmartArtLayoutType استفاده می‌کند اضافه می‌کند و وضعیت مخفی بودن گره اضافه‌شده را بررسی می‌کند. اگر گره مخفی باشد، یک پیام چاپ می‌کند و نمودار را ذخیره می‌نماید.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);
    ISmartArtNode node = smartArt.getAllNodes().addNode();
    boolean isHidden = node.isHidden();

    if (isHidden) {
        System.out.println("The node is hidden in the SmartArt data model.");
    }

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

دریافت یا تنظیم طرح نمودار سازمانی

برای نمودارهای SmartArt که از طرح نمودار سازمانی استفاده می‌کنند، ISmartArtNode.getOrganizationChartLayout و ISmartArtNode.setOrganizationChartLayout تعیین می‌کنند گره‌های فرزند تحت گره مادر چگونه چیده شوند. به عنوان مثال می‌توانید گره‌های فرزند را طوری تنظیم کنید که از سمت چپ، راست یا هر دو طرف آویزان شوند، بسته به OrganizationChartLayoutType انتخاب‌شده.

مثال زیر یک نمودار سازمانی ایجاد می‌کند و طرح گره اول را به مقدار LeftHanging از OrganizationChartLayoutType تنظیم می‌نماید. اندیس صفر‑مبنایی 0 اولین گره سطح بالا را انتخاب می‌کند؛ گره‌های فرزند آن از چیدمان انتخاب‌شده استفاده می‌کنند. سپس ارائهٔ اصلاح‌شده ذخیره می‌شود.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);
    ISmartArtNode rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(OrganizationChartLayoutType.LeftHanging);

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

ایجاد نمودار سازمانی تصویری

نمودار سازمانی تصویری یک طرح SmartArt است که برای نمودارهای سلسله‌مراتبی شامل محل‌های نگهداری تصویر طراحی شده است. هنگام افزودن شیء SmartArt به اسلاید، از مقدار PictureOrganizationChart از SmartArtLayoutType استفاده کنید. این مثال یک نمودار با محل‌های نگهداری تصویر ذخیره می‌کند؛ اما این محل‌ها را با تصویر پر نمی‌کند.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ISmartArt smartArt = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);

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

تبدیل نمودارهای قدیمی به گروهی از اشکال

در هنگام به‌روز رسانی یک ارائه موجود، ممکن است نیاز به به‌روزرسانی یک نمودار سازمانی داشته باشید که در PowerPoint 97–2003 ایجاد شده است. Aspose.Slides این نمودارهای قدیمی را به عنوان اشیاء ILegacyDiagram نشان می‌دهد. برای تبدیل یک نمودار به گروهی از اشکال به‌طوری که بتوانید عناصر بصری فردی را ویرایش کنید، از LegacyDiagram.convertToGroupShape استفاده کنید. برای جزئیات بیشتر به LegacyDiagram API Reference مراجعه کنید.

تبدیل یک گروه جدید به مجموعهٔ اشکال اضافه می‌کند بدون این‌که نمودار اصلی حذف شود. پس از تبدیل موفق، برای جلوگیری از محتوای تکراری، اصلی را با IShapeCollection.remove حذف کنید. قبل از تبدیل، نمودارهای قدیمی را در فهرستی جمع‌آوری کنید تا افزودن و حذف اشکال باعث خراب شدن تکرار نشود.

مثال زیر یک ارائه را باز می‌کند، هر اسلاید را جستجو می‌کند، نمودارها را به گروهی از اشکال تبدیل می‌کند و ارائهٔ به‌روز شده را به صورت PPTX ذخیره می‌نماید.

import com.aspose.slides.*;
import java.util.ArrayList;
import java.util.List;

Presentation presentation = new Presentation("legacy-diagrams.ppt");
try {
    for (ISlide slide : presentation.getSlides()) {
        List<ILegacyDiagram> legacyDiagrams = new ArrayList<>();
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof ILegacyDiagram) {
                legacyDiagrams.add((ILegacyDiagram) shape);
            }
        }

        for (ILegacyDiagram legacyDiagram : legacyDiagrams) {
            IGroupShape groupShape = legacyDiagram.convertToGroupShape();

            if (groupShape != null) {
                slide.getShapes().remove(legacyDiagram);
            }
        }
    }

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

ارائهٔ ذخیره‌شده شامل گروه‌های قابل ویرایش از اشکال به‌جای نمودارهای قدیمی تبدیل‌شده است و دیگر نمودارهای اصلی در کنار آن‌ها وجود ندارد. PPTX را در PowerPoint باز کنید تا عناصر فردی داخل هر گروه، مانند متن، پرکن یا موقعیت آن‌ها را ویرایش کنید.

FAQ

آیا SmartArt از انعکاس یا معکوس کردن برای زبان‌های راست‑به‑چپ پشتیبانی می‌کند؟

بله. متد ISmartArt.setReversed جهت نمودار را از چپ به راست به راست به چپ (یا برعکس) تغییر می‌دهد وقتی طرح SmartArt انتخاب‌شده از معکوس شدن پشتیبانی کند.

چگونه می‌توانم SmartArt را به همان اسلاید یا به ارائهٔ دیگری کپی کنم در حالی که قالب‌بندی حفظ شود؟

می‌توانید با استفاده از کپی کردن شکل SmartArt و ShapeCollection.addClone یا با کلون کردن کل اسلاید که شامل SmartArt است، SmartArt را کپی کنید. هر دو روش اندازه، موقعیت و قالب‌بندی را حفظ می‌کنند.

چگونه می‌توانم SmartArt را به تصویر رستر برای پیش‌نمایش یا خروجی وب رندر کنم؟

می‌توانید با رندر کردن اسلاید یا کل ارائه به PNG یا JPEG. SmartArt به‌عنوان بخشی از اسلاید رندر می‌شود.

چگونه می‌توانم یک شیء SmartArt خاص را در یک اسلاید پیدا کنم اگر چندین مورد وجود داشته باشد؟

از Shape.setAlternativeText یا Shape.setName برای اختصاص یک متن جایگزین یا نام متمایز به شکل SmartArt استفاده کنید، آن مقدار را در BaseSlide.getShapes جستجو کنید، و سپس بررسی کنید که شکل یافت‌شده یک ISmartArt است.