إدارة عقد شكل SmartArt في العروض التقديمية باستخدام Java

إضافة عقدة SmartArt

قدمت Aspose.Slides for Java أبسط واجهة برمجة تطبيقات لإدارة أشكال SmartArt بأبسط طريقة. سيساعدك رمز العينة التالي في إضافة عقدة وعقدة فرعية داخل شكل SmartArt.

إنشاء مثال من الفئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
إضافة عقدة جديدة في شكل SmartArt NodeCollection وتعيين النص في TextFrame.
الآن، إضافة Child Node في عقدة SmartArt المضافة حديثًا وتعيين النص في TextFrame.
حفظ العرض التقديمي.

// تحميل العرض التقديمي المطلوب
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try {
    // المرور عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof SmartArt) 
        {
            // تحويل الشكل إلى SmartArt
            SmartArt smart = (SmartArt) shape;
    
            // إضافة عقدة SmartArt جديدة
            SmartArtNode TemNode = (SmartArtNode) smart.getAllNodes().addNode();
    
            // إضافة نص
            TemNode.getTextFrame().setText("Test");
    
            // إضافة عقدة فرعية جديدة إلى العقدة الأصلية. ستتم إضافتها في نهاية المجموعة
            SmartArtNode newNode = (SmartArtNode) TemNode.getChildNodes().addNode();
    
            // إضافة نص
            newNode.getTextFrame().setText("New Node Added");
        }
    }
    
    // حفظ العرض التقديمي
    pres.save("AddSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

إضافة عقدة SmartArt في موضع محدد

في رمز العينة التالي شرحنا كيفية إضافة العقد الفرعية التابعة للعقد ذات الصلة في شكل SmartArt في موضع معين.

إنشاء مثال من فئة Presentation.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
إضافة شكل StackedList من نوع SmartArt في الشريحة التي تم الوصول إليها.
الوصول إلى العقدة الأولى في شكل SmartArt المضاف.
الآن، إضافة Child Node للعقدة Node المحددة في الموضع 2 وتعيين نصها.
حفظ العرض التقديمي.

// إنشاء نسخة من العرض التقديمي
Presentation pres = new Presentation();
try {
    // الوصول إلى شريحة العرض التقديمي
    ISlide slide = pres.getSlides().get_Item(0);

    // إضافة Smart Art IShape
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);

    // الوصول إلى عقدة SmartArt عند الفهرس 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);

    // إضافة عقدة فرعية جديدة في الموضع 2 داخل العقدة الأصلية
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).addNodeByPosition(2);

    // إضافة نص
    chNode.getTextFrame().setText("Sample Text Added");

    // حفظ العرض التقديمي
    pres.save("AddSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

الوصول إلى عقدة SmartArt

سيساعدك رمز العينة التالي في الوصول إلى العقد داخل شكل SmartArt. يرجى ملاحظة أنه لا يمكنك تغيير LayoutType الخاص بـ SmartArt لأنه للقراءة فقط ويتم تعيينه فقط عند إضافة شكل SmartArt.

إنشاء مثال من فئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
المرور عبر جميع Nodes داخل شكل SmartArt.
الوصول إلى معلومات العقدة مثل موضع العقدة، المستوى والنص.

// إنشاء مثيل من فئة Presentation
Presentation pres = new Presentation("SmartArtShape.pptx");
try {
    // الحصول على الشريحة الأولى
    ISlide slide = pres.getSlides().get_Item(0);
    
    // التنقل عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : slide.getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof ISmartArt) 
        {
            // تحويل نوع الشكل إلى SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // التنقل عبر جميع العقد داخل SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // الوصول إلى عقدة SmartArt عند الفهرس i
                SmartArtNode node = (SmartArtNode) smart.getAllNodes().get_Item(i);
    
                // طباعة معلمات عقدة SmartArt
                System.out.print(node.getTextFrame().getText() + " " + node.getLevel() + " " + node.getPosition());
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

الوصول إلى عقدة فرعية في SmartArt

سيساعدك رمز العينة التالي في الوصول إلى العقد الفرعية التابعة للعقد ذات الصلة في شكل SmartArt.

إنشاء مثال من فئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
المرور عبر جميع Nodes داخل شكل SmartArt.
لكل Node محدد، المرور عبر جميع Child Nodes داخل تلك العقدة.
الوصول إلى معلومات مثل موضع العقدة الفرعية، المستوى والنص.

// إنشاء كائن من فئة Presentation
Presentation pres = new Presentation("AccessChildNodes.pptx");
try {
    // الحصول على الشريحة الأولى
    ISlide slide = pres.getSlides().get_Item(0);
    
    // التنقل عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : slide.getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof ISmartArt) 
        {
            // تحويل نوع الشكل إلى SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            // التنقل عبر جميع العقد داخل SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                // الوصول إلى عقدة SmartArt عند الفهرس i
                SmartArtNode node0 = (SmartArtNode) smart.getAllNodes().get_Item(i);
                
                // التنقل عبر العقد الفرعية في عقدة SmartArt عند الفهرس i
                for (int j = 0; j < node0.getChildNodes().size(); j++) 
                {
                    // الوصول إلى العقدة الفرعية في عقدة SmartArt
                    SmartArtNode node = (SmartArtNode) node0.getChildNodes().get_Item(j);
    
                    // طباعة معلمات العقدة الفرعية في SmartArt
                    System.out.print("j = " + j + ", Text = " + node.getTextFrame().getText() + ",  Level = " + node.getLevel() + ", Position = " + node.getPosition());
                }
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

الوصول إلى عقدة فرعية في SmartArt في موضع محدد

في هذا المثال سنتعلم كيفية الوصول إلى العقد الفرعية في موضع معين تابعة للعقد ذات الصلة في شكل SmartArt.

إنشاء مثال من فئة Presentation .
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
إضافة شكل SmartArt من نوع StackedList .
الوصول إلى شكل SmartArt المضاف.
الوصول إلى العقدة عند الفهرس 0 لشكل SmartArt الذي تم الوصول إليه.
الآن، الوصول إلى Child Node في الموضع 1 للعقدة باستخدام طريقة get_Item().
عرض معلومات مثل موضع العقدة الفرعية، المستوى والنص.

// إنشاء العرض التقديمي
Presentation pres = new Presentation();
try {
    // الوصول إلى الشريحة الأولى
    ISlide slide = pres.getSlides().get_Item(0);
    
    // إضافة شكل SmartArt في الشريحة الأولى
    ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.StackedList);
    
    // الوصول إلى عقدة SmartArt عند الفهرس 0
    ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
    // الوصول إلى العقدة الفرعية عند الموضع 1 في العقدة الأصلية
    int position = 1;
    SmartArtNode chNode = (SmartArtNode) ((SmartArtNodeCollection) node.getChildNodes()).get_Item(position);
    
    // طباعة معلمات العقدة الفرعية في SmartArt
    System.out.print("Text = " + chNode.getTextFrame().getText() + ",  Level = " + chNode.getLevel() + ", Position = " + chNode.getPosition());
} finally {
    if (pres != null) pres.dispose();
}

إزالة عقدة SmartArt

في هذا المثال سنتعلم كيفية إزالة العقد داخل شكل SmartArt.

إنشاء مثال من فئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
التحقق مما إذا كان SmartArt يحتوي على أكثر من 0 عقد.
تحديد عقدة SmartArt التي سيتم حذفها.
الآن، إزالة العقدة المحددة باستخدام طريقة RemoveNode .
حفظ العرض التقديمي.

// تحميل العرض التقديمي المطلوب
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // المرور عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof ISmartArt) 
        {
            // تحويل الشكل إلى SmartArt
            ISmartArt smart = (ISmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // الوصول إلى عقدة SmartArt عند الفهرس 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                // إزالة العقدة المحددة
                smart.getAllNodes().removeNode(node);
            }
        }
    }
    
    // حفظ العرض التقديمي
    pres.save("RemoveSmartArtNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

إزالة عقدة SmartArt من موضع محدد

في هذا المثال سنتعلم كيفية إزالة العقد داخل شكل SmartArt في موضع معين.

إنشاء مثال من فئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الأولى باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
تحديد عقدة شكل SmartArt عند الفهرس 0.
الآن، التحقق مما إذا كانت عقدة SmartArt المحددة تحتوي على أكثر من عقدتين فرعيتين.
الآن، إزالة العقدة في الموقع 1 باستخدام طريقة RemoveNode .
حفظ العرض التقديمي.

// تحميل العرض التقديمي المطلوب
Presentation pres = new Presentation("AddSmartArtNode.pptx");
try {
    // المرور عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof SmartArt) 
        {
            // تحويل الشكل إلى SmartArt
            SmartArt smart = (SmartArt) shape;
    
            if (smart.getAllNodes().size() > 0) 
            {
                // الوصول إلى عقدة SmartArt عند الفهرس 0
                ISmartArtNode node = smart.getAllNodes().get_Item(0);
    
                if (node.getChildNodes().size() >= 2) 
                {
                    // إزالة العقدة الفرعية في الموضع 1
                    (node.getChildNodes()).removeNode(1);
                }
            }
        }
    }
    
    // حفظ العرض التقديمي
    pres.save("RemoveSmartArtNodeByPosition.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تعيين موضع مخصص لعقدة فرعية في كائن SmartArt

الآن يدعم Aspose.Slides for Java تعيين خصائص SmartArtShape X و Y. يوضح المقتطف التالي كيفية تعيين موضع، حجم ودوران SmartArtShape مخصص. يرجى ملاحظة أن إضافة عقد جديدة يتسبب في إعادة حساب مواضع وأحجام جميع العقد. كما أن إعدادات الموضع المخصص تسمح للمستخدم بتعيين العقد وفق المتطلبات.

// إنشاء كائن من فئة Presentation
Presentation pres = new Presentation("SimpleSmartArt.pptx");
try{
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(20, 20, 600, 500, SmartArtLayoutType.OrganizationChart);

    // نقل شكل SmartArt إلى موضع جديد
    ISmartArtNode node = smart.getAllNodes().get_Item(1);
    ISmartArtShape shape = node.getShapes().get_Item(1);
    shape.setX(shape.getX() + shape.getWidth() * 2);
    shape.setY(shape.getY() - shape.getHeight() * 2);

    // تغيير عرض شكل SmartArt
    node = smart.getAllNodes().get_Item(2);
    shape = node.getShapes().get_Item(1);
    shape.setWidth(shape.getWidth() + shape.getWidth() * 2);

    // تغيير ارتفاع شكل SmartArt
    node = smart.getAllNodes().get_Item(3);
    shape = node.getShapes().get_Item(1);
    shape.setHeight(shape.getHeight() + shape.getHeight() * 2);

    // تغيير دوران شكل SmartArt
    node = smart.getAllNodes().get_Item(4);
    shape = node.getShapes().get_Item(1);
    shape.setRotation(90);

    pres.save("SmartArt.pptx", SaveFormat.Pptx);
}finally {
    pres.dispose();
}

التحقق من عقدة المساعد

في هذه المقالة سنستكشف المزيد من ميزات أشكال SmartArt المضافة إلى شرائح العروض التقديمية برمجياً باستخدام Aspose.Slides for Java.

سنستخدم شكل SmartArt المصدر التالي في تحقيقنا في أقسام مختلفة من هذه المقالة.


الشكل: شكل SmartArt المصدر في الشريحة

في الكود العيني التالي سنستكشف كيفية التعرف على العقد المساعدة في مجموعة عقد SmartArt وتغييرها.

إنشاء مثال من فئة Presentation وتحميل العرض التقديمي مع شكل SmartArt.
الحصول على مرجع الشريحة الثانية باستخدام فهرستها.
المرور عبر كل شكل داخل الشريحة الأولى.
التحقق مما إذا كان الشكل من نوع SmartArt وتحويل الشكل المحدد إلى SmartArt إذا كان SmartArt.
المرور عبر جميع العقد داخل شكل SmartArt والتحقق مما إذا كانت Assistant Nodes .
تغيير حالة عقدة المساعد إلى عقدة عادية.
حفظ العرض التقديمي.

// إنشاء نسخة من العرض التقديمي
Presentation pres = new Presentation("AddNodes.pptx");
try {
    // التنقل عبر كل شكل داخل الشريحة الأولى
    for (IShape shape : pres.getSlides().get_Item(0).getShapes()) 
    {
        // التحقق مما إذا كان الشكل من نوع SmartArt
        if (shape instanceof ISmartArt) 
        {
            // تحويل نوع الشكل إلى SmartArt
            ISmartArt smart = (SmartArt) shape;
    
            // التنقل عبر جميع عقد شكل SmartArt
            for (int i = 0; i < smart.getAllNodes().size(); i++) 
            {
                ISmartArtNode node = smart.getAllNodes().get_Item(i);
                // التحقق مما إذا كانت العقدة عقدة مساعد
                if (node.isAssistant()) 
                {
                    // تعيين عقدة المساعد إلى false وجعلها عقدة عادية
                    node.isAssistant();
                }
            }
        }
    }
    
    // حفظ العرض التقديمي
    pres.save("ChangeAssitantNode.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}


الشكل: تغيير العقد المساعدة في شكل SmartArt داخل الشريحة

تعيين تنسيق تعبئة العقدة

يتيح Aspose.Slides for Java إمكانية إضافة أشكال SmartArt مخصصة وتعيين تنسيق التعبئة لها. يشرح هذا المقال كيفية إنشاء والوصول إلى أشكال SmartArt وتعيين تنسيق التعبئة باستخدام Aspose.Slides for Java.

يرجى اتباع الخطوات التالية:

إنشاء مثال من فئة Presentation .
الحصول على مرجع شريحة باستخدام فهرستها.
إضافة شكل SmartArt عن طريق تعيين LayoutType الخاص به.
تعيين FillFormat لعقد شكل SmartArt.
كتابة العرض التقديمي المعدل كملف PPTX.

// إنشاء العرض التقديمي
Presentation pres = new Presentation();
try {
    // الوصول إلى الشريحة
    ISlide slide = pres.getSlides().get_Item(0);
    
    // إضافة شكل SmartArt والعقد
    ISmartArt chevron = slide.getShapes().addSmartArt(10, 10, 800, 60, SmartArtLayoutType.ClosedChevronProcess);
    ISmartArtNode node = chevron.getAllNodes().addNode();
    node.getTextFrame().setText("Some text");
    
    // تعيين لون تعبئة العقدة
    for (IShape item : node.getShapes()) 
    {
        item.getFillFormat().setFillType(FillType.Solid);
        item.getFillFormat().getSolidFillColor().setColor(Color.RED);
    }
    
    // حفظ العرض التقديمي
    pres.save("TestSmart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

إنشاء صورة مصغرة لعقدة فرعية في SmartArt

يمكن للمطورين إنشاء صورة مصغرة لعقدة فرعية في SmartArt باتباع الخطوات التالية:

إنشاء مثال من فئة Presentation .
إضافة SmartArt .
الحصول على مرجع عقدة باستخدام فهرستها.
الحصول على صورة المصغرة.
حفظ صورة المصغرة بأي تنسيق صورة مرغوب.

// إنشاء فئة Presentation التي تمثل ملف PPTX 
Presentation pres = new Presentation();
try {
    // إضافة SmartArt 
    ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicCycle);

    // الحصول على مرجع عقدة باستخدام الفهرس الخاص بها  
    ISmartArtNode node = smart.getNodes().get_Item(1);

    // الحصول على الصورة المصغرة
    IImage slideImage = node.getShapes().get_Item(0).getImage();

    // حفظ الصورة المصغرة
    try {
          slideImage.save("SmartArt_ChildNote_Thumbnail.png", ImageFormat.Png);
    } finally {
         if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

الأسئلة المتكررة

هل تدعم رسوم SmartArt المتحركة؟

نعم. يُعامل SmartArt كشكل عادي، لذا يمكنك تطبيق الرسوم المتحركة القياسية (دخول، خروج، تأكيد، مسارات حركة) وضبط التوقيت. يمكنك أيضًا تحريك الأشكال داخل عقد SmartArt عند الحاجة.

كيف يمكنني تحديد موقع SmartArt معين على شريحة إذا كان معرفه الداخلي غير معروف؟

قم بتعيين والبحث باستخدام [النص البديل]https://reference.aspose.com/slides/java/com.aspose.slides/shape/#getAlternativeText–). تعيين AltText مميز على SmartArt يتيح لك العثور عليه برمجياً دون الاعتماد على المعرفات الداخلية.

هل سيتم الحفاظ على مظهر SmartArt عند تحويل العرض التقديمي إلى PDF؟

نعم. يقوم Aspose.Slides بتصدير SmartArt بدقة بصرية عالية أثناء تصدير PDF، مع الحفاظ على التخطيط والألوان والتأثيرات.

هل يمكنني استخراج صورة لكامل SmartArt (للعروض المسبقة أو التقارير)؟

نعم. يمكنك تصيير شكل SmartArt إلى [صيغ نقطية]https://reference.aspose.com/slides/java/com.aspose.slides/shape/#getImage-int-float-float- أو إلى [SVG]https://reference.aspose.com/slides/java/com.aspose.slides/shape/#writeAsSvg-java.io.OutputStream-com.aspose.slides.ISVGOptions- للحصول على مخرجات متجهية قابلة للتوسيع، مما يجعله مناسباً للصور المصغرة أو التقارير أو الاستخدام على الويب.

إدارة رسومات SmartArt في العروض التقديمية باستخدام Java