إدارة أشكال العروض التقديمية في Python عبر Java

عن ماذا تتحدث هذه الصفحة

تعلم كيفية تحديد، ضبط، استنساخ، إزالة، إخفاء، إعادة ترتيب، تصدير، محاذاة، وقلب أشكال العروض التقديمية باستخدام Aspose.Slides for Python عبر Java.

نظرة عامة

تمثل مكتبة Aspose.Slides for Python عبر Java الأشكال على الشريحة كمجموعة مرتبة من ShapeCollection. تُستخدم المجموعة لتحديد وتعديل الأشكال، كما تُعرّف ترتيب تكدسها: الفهرس 0 هو الشكل الأبعد في الخلفية، بينما الفهرس الأخير هو الشكل الأقرب إلى الواجهة.

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

تحديد وإيجاد الأشكال

تُعد فهارس المجموعة مريحة عند معالجة ملف معروف، لكنها ليست معرّفات ثابتة. يمكن أن تُغيّر إضافة أو حذف أو إعادة ترتيب شكل فهرسه. اختر معرّفًا وفقًا لكيفية إنشاء العرض التقديمي وصيانته:

Name مفيد للقوالب التي يتحكم فيها المطور وسهل الفحص في جزء الاختيار داخل PowerPoint. يمكن تعديل الأسماء ولا يُضمن أن تكون فريدة، لذا ضع قاعدة تسمية إذا كانت الشيفرة تعتمد عليها.
AlternativeText مفيد عندما تكون الوصف الأخلاقي أو العلامة التي يضيفها المؤلف قد حددت الشكل بالفعل. يُظهر للمستخدمين، قد يُترجم أو يُعاد كتابته للتمكين، ولا يُضمن أن يكون فريدًا. لا تُعيد استخدام نص الوصف المهم كمفتاح قاعدة بيانات بصمت.
OfficeInteropShapeId هو معرّف للقراءة فقط فريد داخل الشريحة ويتطابق مع معرف الشكل المستخدم من قبل PowerPoint interop. استخدمه عند التكامل مع PowerPoint أو عندما تحتاج إلى مرجع لا غنى عنه طوال فترة وجود الشكل. الشكل المستنسخ أو المُعاد إنشاؤه يُعطى معرفًا مختلفًا.

الطريقة المرتبطة getUniqueId تُعيد معرّفًا بنطاق العرض التقديمي، لكن هذا المعرف مخصص للإضافات ويمكن إعادة تعيينه. لا يجب اعتباره مفتاحًا خارجيًا دائمًا. إذا كان الهوية طويلة الأمد ضرورية، احفظ التناظر في بيانات التطبيق وتأكد من أن الشكل المتوقع لا يزال موجودًا.

المثال التالي يبحث عن اسم باستخدام مقارنة دقيقة ويُظهر معرف interop النطاق الشريحي. عندما لا يحتوي القالب على الشكل المتوقع، يُبلغ الكود عن ذلك بدلاً من المتابعة مع الكائن الخطأ.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("input.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    target_shape = None
    for shape in slide.getShapes():
        if shape.getName() == "RevenueChart":
            target_shape = shape
            break

    if target_shape is None:
        print("The shape 'RevenueChart' was not found on slide 1.")
    else:
        print(f"Found {target_shape.getName()}; interop ID: {target_shape.getOfficeInteropShapeId()}")
finally:
    presentation.dispose()

عند أن العملية خاصة بنوع شكل معين، تحقّق من النوع قبل استخدام الأعضاء الخاصة بالنوع. يُحدِّث هذا المثال النص والنص البديل فقط إذا كان الكائن المُسمّى هو AutoShape.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, Presentation, SaveFormat

presentation = Presentation("input.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    candidate = None
    for shape in slide.getShapes():
        if shape.getName() == "StatusLabel":
            candidate = shape
            break

    if isinstance(candidate, AutoShape):
        candidate.getTextFrame().setText("Approved")
        candidate.setAlternativeText("Approval status: approved")
        presentation.save("identified-shape.pptx", SaveFormat.Pptx)
    else:
        print("'StatusLabel' is missing or is not an AutoShape.")
finally:
    presentation.dispose()

تحديد وتعديل ضبط الشكل المعرّف مسبقًا

يمكن لأشكال الهندسة المعرّفة مسبقًا إظهار نقاط ضبط تتحكم في ميزات مثل حجم الزوايا، نسب السهم، أو زوايا القوس. يمكن الوصول إليها عبر مجموعة القراءة فقط GeometryShape.getAdjustments. تُقدّم المجموعة نفسها من قبل الشكل، لكن كل AdjustValue يحتوي على قيمة يمكن تعديلها.

لا تعتمد فقط على فهرس ثابت للمجموعة. كرّر عبر الضبط وتفحص طريقة القراءة فقط getType، التي تُعيد قيمة ShapeAdjustmentType التي تصف ما يتحكم به الضبط. تُوفر طريقة القراءة فقط getName معلومات تعريف إضافية وهي مفيدة خصوصًا عندما يحتوي الضبط المعرّف مسبقًا على أكثر من ضبط من نفس النوع الدلالي.

استخدم طريقة القيمة التي تتوافق مع معنى الضبط:

Adjustment type	Purpose	Value to change
CornerSize	حجم الزوايا المدورة	setRawValue
ArrowTailThickness	سماكة ذيل السهم	setRawValue
ArrowheadLength	طول رأس السهم	setRawValue
ArrowheadWidth	عرض رأس السهم	setRawValue
StartAngle	زاوية البدء لقطة أو قوس	setAngleValue
EndAngle	زاوية النهاية لقطة أو قوس	setAngleValue

تُعيد getType وgetName معلومات للقراءة فقط. يعمل getRawValue وsetRawValue مع عدد صحيح بوحدات الهندسة الأصلية للضبط، بينما يعمل getAngleValue وsetAngleValue مع زاوية بالدرجات. يعتمد عدد، ترتيب، معنى، ونطاق الضبط الصالح على ShapeType المعرّف مسبقًا. قد تكون القيمة الصالحة لضبط واحد غير صالحة أو لها تأثير مختلف لضبط آخر.

عندما تُعيد getType ShapeAdjustmentType.Custom، لا تتعرف الواجهة البرمجية على معنى دلالي قياسي. افحص getName، نوع الضبط المعرّف مسبقًا، والقيمة الحالية، واترك الضبط دون تغيير ما لم يكن المعنى والنطاق معروفين. حتى للأنواع المعروفة، تحقق ما إذا كان النوع نفسه يظهر أكثر من مرة قبل اختيار قيمة. تُظهر مقالة Connector هذه الحالة مع ضبط انحناءات الموصل.

المثال الكامل التالي يخلق إصدارات افتراضية ومعدّلة لثلاثة أشكال مُعرّفة مسبقًا. يكرّر عبر كل ضبط، يُبلغ عن اسمه ونوعه، يغيّر القيم المتعلقة بالحجم عبر setRawValue، يغيّر الزوايا عبر setAngleValue، ويحفظ النتيجة. العمود الأيسر يحتفظ بالهندسة الافتراضية؛ العمود الأيمن يُظهر المستطيل المدور المعدل، السهم رباعي الاتجاهات، والقطعة الدائرية.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeAdjustmentType, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # يضيف رؤوسًا لأعمدة الشكل الافتراضية والمعدلة.
    default_column_label = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 20, 250, 30)
    default_column_label.getTextFrame().setText("Default preset geometry")
    adjusted_column_label = slide.getShapes().addAutoShape(ShapeType.Rectangle, 390, 20, 250, 30)
    adjusted_column_label.getTextFrame().setText("Modified adjustment values")

    slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 80, 70, 160, 70)
    modified_rounded_rectangle = slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 430, 70, 160, 70)
    modified_rounded_rectangle.setName("ModifiedRoundedRectangle")

    slide.getShapes().addAutoShape(ShapeType.QuadArrow, 80, 180, 160, 110)
    modified_arrow = slide.getShapes().addAutoShape(ShapeType.QuadArrow, 430, 180, 160, 110)
    modified_arrow.setName("ModifiedQuadArrow")

    slide.getShapes().addAutoShape(ShapeType.Pie, 95, 330, 130, 130)
    modified_pie = slide.getShapes().addAutoShape(ShapeType.Pie, 445, 330, 130, 130)
    modified_pie.setName("ModifiedPie")

    shapes_to_adjust = [modified_rounded_rectangle, modified_arrow, modified_pie]

    for shape in shapes_to_adjust:
        for adjustment_index in range(shape.getAdjustments().size()):
            adjustment = shape.getAdjustments().get_Item(adjustment_index)
            print(f"{shape.getName()} / {adjustment.getName()}: {adjustment.getType()}")

            if adjustment.getType() == ShapeAdjustmentType.CornerSize:
                adjustment.setRawValue(5000)
            elif adjustment.getType() == ShapeAdjustmentType.ArrowTailThickness:
                adjustment.setRawValue(25000)
            elif adjustment.getType() == ShapeAdjustmentType.ArrowheadLength:
                adjustment.setRawValue(30000)
            elif adjustment.getType() == ShapeAdjustmentType.ArrowheadWidth:
                adjustment.setRawValue(40000)
            elif adjustment.getType() == ShapeAdjustmentType.StartAngle:
                adjustment.setAngleValue(30)
            elif adjustment.getType() == ShapeAdjustmentType.EndAngle:
                adjustment.setAngleValue(300)
            elif adjustment.getType() == ShapeAdjustmentType.Custom:
                print(f"Custom adjustment '{adjustment.getName()}' was not changed.")

    presentation.save("preset-shape-adjustments.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

التحقق من النوع الدلالي قبل تغيير قيمة يجعل الشيفرة صريحة بشأن نيتها ويتجنّب الافتراض بأن فهرس مجموعة ثابت يحمل نفس المعنى عبر أشكال مُعرّفة مسبقًا مختلفة.

تعديل مجموعة الأشكال

تُطبق طرق الإضافة، الاستنساخ، الحذف، وإعادة الترتيب على المجموعة فورًا. إذا غيرت عملية ما عدد أو ترتيب الأشكال، لا تواصل الاعتماد على الفهارس التي تم التقاطها قبل تلك العملية.

استنساخ شكل

addClone يخلق نسخة مستقلة ويضيفها إلى نهاية المجموعة الهدف. insertClone يخلق نسخة أيضًا لكنه يضعها عند فهرس z-order محدد. التحميل الزائد الذي يقبل إحداثيات يحرك النسخة دون تغيير حجمها؛ التحميل الزائد الذي يحدد العرض والارتفاع يمكنه تغيير الحجم كذلك.

المثال يخلق شريحة هدف، يستنسخ مستطيلًا معنونا إلى الأمام، ويُدخل نسخة ثانية إلى الخلف. لا تُغيّر أي من النسختين المصدر.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AutoShape, Presentation, SaveFormat, ShapeType, SlideLayoutType

presentation = Presentation()
try:
    source_slide = presentation.getSlides().get_Item(0)
    source_shape = source_slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 180, 60)
    source_shape.setName("SourceLabel")
    source_shape.getTextFrame().setText("Source")

    blank_layout = presentation.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank)
    destination_slide = presentation.getSlides().addEmptySlide(blank_layout)

    front_clone_shape = destination_slide.getShapes().addClone(source_shape, 80, 80)
    front_clone_shape.setName("FrontClone")
    if isinstance(front_clone_shape, AutoShape):
        front_clone_shape.getTextFrame().setText("Front clone")
    else:
        print("The front clone is not an AutoShape; its text was not changed.")

    back_clone_shape = destination_slide.getShapes().insertClone(0, source_shape, 80, 180)
    back_clone_shape.setName("BackClone")
    if isinstance(back_clone_shape, AutoShape):
        back_clone_shape.getTextFrame().setText("Back clone")
    else:
        print("The back clone is not an AutoShape; its text was not changed.")

    presentation.save("cloned-shapes.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

الاستنساخ ينسخ محتوى الشكل وتنسيقه، بما في ذلك اسمه والنص البديل. عيّن معرّفات منطقية جديدة للنسخة عندما يجب أن تكون تلك القيم فريدة. تُدار الموارد المستخدمة بواسطة الأشكال المعقّدة من قبل العرض التقديمي، لكن النسخة تظل عنصر مجموعة جديد بمعرف شكل جديد.

حذف أشكال

remove يحذف كائن شكل محدد من مجموعته. عند حذف تطابقات متعددة أثناء التكرار بالفهارس، تجوَّل من النهاية بحيث يظل كل فهرس متبقٍ صالحًا.

المثال يزيل كل شكل يحمل اسمًا معينًا. يقرأ الشكل عند الفهرس الحالي، وليس عنصر مجموعة ثابت، ولا يتحوّل الشكل إلى نوع آخر دون ضرورة.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    keep_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 140, 60)
    keep_shape.setName("Keep")

    first_temporary_shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 220, 40, 80, 80)
    first_temporary_shape.setName("Temporary")

    second_temporary_shape = slide.getShapes().addAutoShape(ShapeType.Triangle, 340, 40, 100, 80)
    second_temporary_shape.setName("Temporary")

    for i in range(slide.getShapes().size() - 1, -1, -1):
        shape = slide.getShapes().get_Item(i)
        if shape.getName() == "Temporary":
            slide.getShapes().remove(shape)

    presentation.save("removed-shapes.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

بعد الحذف، يتغيّر عدد الأشكال وفهارس الأشكال اللاحقة. تبقى الإشارات إلى الأشكال غير المتأثرة أكثر موثوقية من الفهارس المحفوظة. ضع في اعتبارك الموصلات، الرسوم المتحركة، وميزات العرض الأخرى التي قد تشير إلى الكائن المحذوف؛ حذف شكل مرئي قد يغيّر أكثر من مظهر الشريحة.

إخفاء شكل

ضبط Hidden إلى True يبقي الشكل في المجموعة لكنه يمنعه من الظهور في عرض الشرائح العادي. يظل فهرسه وتنسيقه ومحتواه متاحًا للشيفرة، لذا يُعد الإخفاء مناسبًا للعناصر الاختيارية التي قد تُستعاد لاحقًا.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    visible_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 160, 60)
    visible_shape.setName("VisibleLabel")

    optional_shape = slide.getShapes().addAutoShape(ShapeType.Moon, 240, 40, 100, 100)
    optional_shape.setName("OptionalDecoration")

    for shape in slide.getShapes():
        if shape.getName() == "OptionalDecoration":
            shape.setHidden(True)

    presentation.save("hidden-shape.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

الإخفاء ليس حذفًا ولا أمانًا. لا يزال بالإمكان اكتشاف الكائن وإظهاره مرة أخرى من قبل المستخدم أو الشيفرة، ويظل جزءًا من ملف العرض التقديمي.

تغيير ترتيب Z

تُرسم الأشكال المتداخلة بترتيب المجموعة. reorder ينقل شكلًا موجودًا إلى فهرس الهدف دون استنساخه. الفهرس 0 هو الخلف؛ size ناقص واحد هو الأمام.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    blue_rectangle = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 220, 120)
    blue_rectangle.setName("BlueRectangle")
    blue_rectangle.getFillFormat().setFillType(FillType.Solid)
    blue_rectangle.getFillFormat().getSolidFillColor().setColor(Color.BLUE)

    orange_ellipse = slide.getShapes().addAutoShape(ShapeType.Ellipse, 180, 140, 220, 120)
    orange_ellipse.setName("OrangeEllipse")
    orange_ellipse.getFillFormat().setFillType(FillType.Solid)
    orange_ellipse.getFillFormat().getSolidFillColor().setColor(Color.ORANGE)

    slide.getShapes().reorder(slide.getShapes().size() - 1, blue_rectangle)
    presentation.save("reordered-shapes.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

يُنشأ المستطيل أولًا ويقع في البداية خلف الشكل البيضاوي. نقله إلى الفهرس النهائي يجعله في الأمام. أنهِ ترتيب Z بعد إضافة أو استنساخ جميع الأشكال المرتبطة، لأن هذه العمليات تُضيف أو تُدخل عناصر مجموعة جديدة وقد تُغيّر التكدس المقصود.

فحص الأشكال على شرائح التخطيط

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

المثال التالي يقرأ كل شكل تخطيط ويستخرج FillFormat وLineFormat دون افتراض أن كل شكل هو AutoShape.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("input.pptx")
try:
    for layout_slide in presentation.getLayoutSlides():
        for shape in layout_slide.getShapes():
            fill_type = shape.getFillFormat().getFillType()
            line_width = shape.getLineFormat().getWidth()
            print(f"{layout_slide.getName()} / {shape.getName()}: fill={fill_type}, line width={line_width}")
finally:
    presentation.dispose()

يمكن لتعديل التخطيط أن يؤثر على عدة شرائح تستخدمه. قبل تغيير شكل التخطيط، حدّد ما إذا كانت شريحة عادية تُورث الكائن أو تحتوي على تجاوز محلي، واختبر كل شريحة تستخدم ذلك التخطيط.

تصدير شكل إلى SVG

طريقة writeAsSvg من Shape تُكتب محتوى شكل واحد مُرسَم إلى تدفق. النتيجة تحتوي على الشكل فقط، لا الخلفية الكاملة للشريحة أو الأشكال المجاورة.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation
from pathlib import Path
from java.io import ByteArrayOutputStream

presentation = Presentation("input.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    if slide.getShapes().size() == 0:
        print("Slide 1 does not contain a shape to export.")
    else:
        shape = slide.getShapes().get_Item(0)
        svg_stream = ByteArrayOutputStream()
        try:
            shape.writeAsSvg(svg_stream)
            svg_bytes = bytes(svg_stream.toByteArray())
            Path("shape.svg").write_bytes(svg_bytes)
        except OSError as exception:
            print(f"The SVG file could not be written: {exception}")
        finally:
            svg_stream.close()
finally:
    presentation.dispose()

احتفظ بالعرض التقديمي مفتوحًا أثناء التصدير. يعتمد الإخراج على تنسيق الشكل وعلى موارد مثل الخطوط والصور. إذا كنت تحتاج إلى التكوين الكامل، صدّر الشريحة بدلاً من شكل فردي. يمتلك المُستدعي التدفق ويجب أن يغلقه.

محاذاة الأشكال

تُطابق التحميلات الزائدة SlideUtil.alignShapes إما كل الأشكال أو مؤشرات مجموعة مختارة. تُحدد ShapesAlignmentType الحافة، أو الخط المركزي، أو وضع التوزيع. اضبط align_to_slide إلى True لاستخدام حواف الشريحة؛ اضبطه إلى False لمطابقة الأشكال المحددة بالنسبة إلى بعضها البعض.

المثال يطابق ثلاثة أشكال إلى الحافة العليا للشريحة. تُحوَّل مراجع الأشكال المرجعة إلى فهارسها الحالية مباشرةً قبل المطابقة.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType, ShapesAlignmentType, SlideUtil

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    first_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 60, 80, 120, 50)
    second_shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 240, 160, 120, 50)
    third_shape = slide.getShapes().addAutoShape(ShapeType.Triangle, 420, 240, 120, 50)
    first_shape.setName("FirstAlignedShape")
    second_shape.setName("SecondAlignedShape")
    third_shape.setName("ThirdAlignedShape")

    shape_indexes = jpype.JArray(jpype.JInt)([slide.getShapes().indexOf(first_shape), slide.getShapes().indexOf(second_shape), slide.getShapes().indexOf(third_shape)])

    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, True, slide, shape_indexes)
    presentation.save("aligned-shapes.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

المطابقة تُغيّر المواقع، لا ترتيب Z. عادةً ما يحتاج المطابق النسبي إلى شكلين على الأقل، بينما يتطلب التوزيع الأفقي أو العمودي عددًا كافيًا من الأشكال لتحديد الفواصل. أعد حساب الفهارس إذا عدّلت المجموعة قبل استدعاء الطريقة.

تدوير شكل

تخزن فئة ShapeFrame الموضع، الحجم، إعدادات الانعكاس الأفقي والعمودي، والدوران. تُستخدم قيم getFlipH وgetFlipV من نوع NullableBool: True يفعّل الانعكاس، False يعطله، وNotDefined يحافظ على الحالة غير المحددة/الافتراضية.

العرض التقديمي المدخل أدناه يحتوي على شكل غير مُنعكس.

The shape before flipping

المثال يحافظ على جميع قيم الإطار الأخرى ويستبدل فقط إعدادات الانعكاس الثنائية. هذا مهم لأن تعيين Frame جديد يحل محل الإطار الكامل.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import NullableBool, Presentation, SaveFormat, ShapeFrame

presentation = Presentation("sample.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    frame = shape.getFrame()

    print(f"Horizontal flip before change: {frame.getFlipH()}")
    print(f"Vertical flip before change: {frame.getFlipV()}")

    flipped_frame = ShapeFrame(frame.getX(), frame.getY(), frame.getWidth(), frame.getHeight(), NullableBool.True_, NullableBool.True_, frame.getRotation())
    shape.setFrame(flipped_frame)

    presentation.save("flipped-shape.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

الشكل المحفوظ يُعكس أفقيًا وعموديًا مع الحفاظ على موضعه وحجمه ودورانه.

The shape after flipping

الأسئلة الشائعة

هل يجب علي استخدام فهرس المجموعة كمعرف للشكل؟

فقط للمعالجة المؤقتة عندما لا تتغيّر المجموعة قبل استخدام الفهرس. يُفضَّل اعتماد Name أو AlternativeText كمعيار للقوالب التي تم إنشاؤها، أو OfficeInteropShapeId لأعمال interop ذات نطاق الشريحة.

هل إخفاء الشكل يزيله من ترتيب Z؟

لا. يبقى الشكل المخفي في المجموعة عند نفس الفهرس. يمكن العثور عليه، إعادة ترتيبه، تحريره، أو إظهاره مرة أخرى.

لماذا ظهر شكل مستنسخ في أمام شكل آخر؟

addClone يضيف النسخة إلى نهاية المجموعة، وهي أمامية ترتيب Z. استخدم insertClone لاختيار الفهرس الأولي أو reorder بعد إضافة جميع الأشكال.

هل يمكنني استخدام فهرس ثابت لتحديد ضبط شكل مُعرّف مسبقًا؟

فقط بعد التحقق من الضبط المعرّف مسبقًا وترتيب المجموعة بدقة. يُفضَّل التكرار عبر GeometryShape.getAdjustments وفحص AdjustValue.getType؛ استخدم AdjustValue.getName كمعلومة إضافية عندما يظهر نفس النوع الدلالي أكثر من مرة.

تطبيق مؤثرات الشكل في العروض باستخدام بايثون عبر جافا الحصول على الخصائص الفعّالة للأشكال من العروض التقديمية في بايثون عبر جافا