إدارة الأشكال في العروض التقديمية باستخدام بايثون

نظرة عامة

يقدم هذا الدليل معالجة الأشكال في Aspose.Slides for Python عبر .NET. تعرّف على الأنماط العملية للعثور على الأشكال (بما في ذلك بواسطة النص البديل)، نسخها، حذفها أو إخفائها، إعادة ترتيبها، محاذاتها وقلبها، قراءة المعرفات وتنسيقها بناءً على التخطيط، وتصدير الأشكال الفردية إلى SVG باستخدام واجهتي برمجة التطبيقات Presentation و Shape.

العثور على الأشكال في الشرائح

يتعرف PowerPoint على الأشكال فقط عبر المعرفات الداخلية. قم بتعيين نص بديل فريد للشكل المستهدف في PowerPoint، ثم افتح العرض التقديمي باستخدام Aspose.Slides for Python، وكرر عبر أشكال الشريحة، واختر الشكل الذي يتطابق نصه البديل مع النص المعين. تُنفّذ الطريقة find_shape هذا النهج وتعيد الشكل المطابق.

import aspose.slides as slides

# يبحث عن شكل في الشريحة بواسطة النص البديل الخاص به.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# إنشاء كائن من فئة Presentation التي تمثل ملف عرض تقديمي.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # البحث عن الشكل الذي لديه النص البديل "Shape1".
    shape = find_shape(slide, "Shape1")
    if shape is not None:
        print("Shape name:", shape.name)

استنساخ الأشكال

لاستنساخ الأشكال من شريحة مصدر إلى شريحة جديدة في Aspose.Slides، اتبع الخطوات التالية:

1. إنشاء كائن Presentation من الملف المصدر.
2. الحصول على الشريحة المصدر حسب الفهرس ومجموعتها من الأشكال.
3. استخراج تخطيط فارغ من الشريحة الرئيسية.
4. إضافة شريحة فارغة باستخدام ذلك التخطيط والحصول على أشكالها.
5. استنساخ الأشكال إلى الشريحة الهدف.
6. حفظ العرض التقديمي كملف PPTX.

الشفرة التالية توضح استنساخ الأشكال من شريحة إلى أخرى.

import aspose.slides as slides

# إنشاء كائن من فئة Presentation.
with slides.Presentation("sample.pptx") as presentation:
    source_shapes = presentation.slides[0].shapes
    blank_layout = presentation.masters[0].layout_slides.get_by_type(slides.SlideLayoutType.BLANK)

    target_slide = presentation.slides.add_empty_slide(blank_layout)
    target_shapes = target_slide.shapes
	
    target_shapes.add_clone(source_shapes[1], 50, 150 + source_shapes[0].height)
    target_shapes.add_clone(source_shapes[2])
    target_shapes.insert_clone(0, source_shapes[0], 50, 150)

    # حفظ العرض التقديمي إلى القرص.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

إزالة الأشكال

تتيح لك Aspose.Slides إزالة أي شكل من الشريحة. على سبيل المثال، لحذف شكل من الشريحة الأولى باستخدام النص البديل الخاص به، اتبع الخطوات التالية:

1. إنشاء كائن Presentation وتحميل الملف.
2. الوصول إلى الشريحة الأولى من مجموعة الشرائح.
3. العثور على الشكل عبر قيمة النص البديل.
4. إزالة الشكل من مجموعة أشكال الشريحة.
5. حفظ العرض التقديمي على القرص بصيغة PPTX.

import aspose.slides as slides

# يبحث عن شكل في شريحة بواسطة النص البديل الخاص به.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# إنشاء كائن من فئة Presentation التي تمثل ملف عرض تقديمي.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # ابحث عن الشكل الذي لديه النص البديل "User Defined".
    shape = find_shape(slide, "User Defined")
    # إزالة الشكل.
    slide.shapes.remove(shape)
    # حفظ العرض التقديمي إلى القرص.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

إخفاء الأشكال

تتيح لك Aspose.Slides إخفاء أي شكل على الشريحة. على سبيل المثال، لإخفاء شكل على الشريحة الأولى باستخدام النص البديل الخاص به، اتبع الخطوات التالية:

1. إنشاء كائن Presentation وتحميل الملف.
2. الوصول إلى الشريحة الأولى من مجموعة الشرائح.
3. العثور على الشكل عبر قيمة النص البديل.
4. إخفاء الشكل.
5. حفظ العرض التقديمي على القرص بصيغة PPTX.

# يبحث عن شكل في الشريحة بواسطة النص البديل الخاص به.
def find_shape(slide, alt_text):
    for slide_shape in slide.shapes:
        if slide_shape.alternative_text == alt_text:
            return slide_shape
    return None


# إنشاء كائن من فئة Presentation التي تمثل ملف عرض تقديمي.
with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # ابحث عن الشكل الذي لديه النص البديل "User Defined".
    shape = find_shape(slide, "User Defined")
    # إخفاء الشكل.
    shape.hidden = True
    # حفظ العرض التقديمي إلى القرص.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

تغيير ترتيب الأشكال

تسمح لك Aspose.Slides بإعادة ترتيب الأشكال (تغيير ترتيبها في المحور z). يحدد إعادة الترتيب أي شكل يظهر أمام أو خلف الآخر. على سبيل المثال، لإعادة ترتيب شكلين على الشريحة الأولى، اتبع الخطوات أدناه:

1. إنشاء كائن من فئة Presentation.
2. الوصول إلى الشريحة الأولى.
3. إضافة الشكل الأول (مثلاً، مستطيل).
4. إضافة الشكل الثاني (مثلاً، مثلث).
5. إعادة ترتيب الأشكال بنقل الشكل الثاني إلى الموقع الأول في المجموعة.
6. حفظ العرض التقديمي على القرص.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    # أضف شكلين إلى الشريحة.
    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 200, 150)
    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.TRIANGLE, 20, 200, 200, 150)
    # انقل الشكل الثاني إلى الموضع الأول.
    slide.shapes.reorder(0, shape2)
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

الحصول على معرف الشكل Interop

تتيح لك Aspose.Slides الحصول على معرف فريد للشكل على مستوى الشريحة، على عكس الخاصية unique_id التي تكون فريدة على مستوى العرض بأكمله. الخاصية office_interop_shape_id متوفرة على فئة Shape. قيمتها تتطابق مع الخاصية Id لكائن Microsoft.Office.Interop.PowerPoint.Shape. يُظهر المقتطف البرمجي التالي مثالاً على ذلك.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    # احصل على المعرف الفريد للشكل داخل الشريحة.
    officeInteropShapeId = presentation.slides[0].shapes[0].office_interop_shape_id

تعيين النص البديل للأشكال

تسمح لك Aspose.Slides بتعيين نص بديل لأي شكل. يمكنك استخدام النص البديل لتحديد موقع الأشكال في العرض التقديمي. يمكن قراءة وكتابة خاصية النص البديل عبر Aspose.Slides وMicrosoft PowerPoint. من خلال وسم الأشكال بهذه الخاصية، يمكنك لاحقًا إزالتها أو إخفاؤها أو إعادة ترتيبها على الشريحة.

لتعيين النص البديل لشكل، اتبع الخطوات التالية:

1. إنشاء كائن من فئة Presentation.
2. الوصول إلى الشريحة الأولى.
3. إضافة شكل إلى الشريحة.
4. تعيين النص البديل.
5. حفظ العرض التقديمي على القرص.

import aspose.slides as slides

# إنشاء كائن من فئة Presentation التي تمثل ملف PPTX.
with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    # أضف شكلاً.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 40, 150, 50)
    # تعيين النص البديل للشكل.
    shape.alternative_text = "User Defined"
    # حفظ العرض التقديمي إلى القرص.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

الوصول إلى تنسيقات التخطيط للأشكال

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

import aspose.slides as slides

with slides.Presentation(folder_path + "sample.pptx") as presentation:
    for layout_slide in presentation.layout_slides:
        fill_formats = list(map(lambda shape: shape.fill_format, layout_slide.shapes))
        line_formats = list(map(lambda shape: shape.line_format, layout_slide.shapes))

تحويل الأشكال إلى SVG

تدعم Aspose.Slides تحويل الأشكال إلى SVG. تسمح لك الطريقة write_as_svg (وبالتحميلات المتعددة لها) على فئة Shape بحفظ محتويات الشكل كصورة SVG. يوضح المقتطف البرمجي أدناه كيفية تصدير شكل إلى ملف SVG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    with open("output.svg", "wb") as image_stream:
        # احصل على الشكل الأول في الشريحة الأولى.
        shape = presentation.slides[0].shapes[0]
        shape.write_as_svg(image_stream)

محاذاة الشكل

باستخدام الطريقة align_shape في فئة SlidesUtil، يمكنك:

• محاذاة الأشكال بالنسبة لهوامش الشريحة (انظر مثال 1).
• محاذاة الأشكال بالنسبة لبعضها البعض (انظر مثال 2).

تحدد تعداد ShapesAlignmentType خيارات المحاذاة المتاحة.

مثال 1

يعرض هذا الكود بايثون كيفية محاذاة الأشكال ذات الفهارس 1 و2 و4 إلى الحافة العلوية للشريحة:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_TOP
slide_indices = [1, 2, 4]

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    slides.util.SlideUtil.align_shapes(align_type, True, slide, slide_indices)

مثال 2

يعرض هذا المثال بايثون كيفية محاذاة جميع الأشكال في مجموعة بالنسبة إلى الشكل الأدنى في تلك المجموعة:

import aspose.slides as slides

align_type = slides.ShapesAlignmentType.ALIGN_BOTTOM

with slides.Presentation("sample.pptx") as presentation:
    slides.util.SlideUtil.align_shapes(align_type, False, presentation.slides[0])

خصائص الانعكاس

في Aspose.Slides، توفر فئة ShapeFrame التحكم في انعكاس الأشكال أفقيًا وعموديًا عبر خصائص flip_h و flip_v. كلا الخصائص من نوع NullableBool، وتسمح بالقيم TRUE لتفعيل الانعكاس، FALSE لعدم الانعكاس، أو NOT_DEFINED لاستخدام السلوك الافتراضي. يمكن الوصول إلى هذه القيم من خلال Frame الشكل.

لتعديل إعدادات الانعكاس، يتم إنشاء مثيل جديد من ShapeFrame باستخدام الموقع الحالي وحجم الشكل، والقيم المطلوبة لـ flip_h و flip_v، وزاوية الدوران. يتم تعيين هذا المثيل إلى Frame الشكل وحفظ العرض التقديمي لتطبيق التحولات وتعزيزها في الملف الناتج.

لنفترض أننا نملك ملف sample.pptx يحتوي على شريحة أولى بها شكل واحد بإعدادات انعكاس افتراضية، كما هو موضح أدناه.

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

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    # استرجاع خاصية الانعكاس الأفقي للشكل.
    horizontal_flip = shape.frame.flip_h
    print("Horizontal flip:", horizontal_flip)

    # استرجاع خاصية الانعكاس العمودي للشكل.
    vertical_flip = shape.frame.flip_v
    print("Vertical flip:", vertical_flip)

    x, y = shape.frame.x, shape.frame.y
    width, height = shape.frame.width, shape.frame.height
    flip_h, flip_v = slides.NullableBool.TRUE, slides.NullableBool.TRUE  # انعكاس أفقي وعمودي.
    rotation = shape.frame.rotation

    shape.frame = slides.ShapeFrame(x, y, width, height, flip_h, flip_v, rotation)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

النتيجة:

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

هل يمكنني دمج الأشكال (اتحاد/تقاطع/طرح) على شريحة كما في محرر سطح المكتب؟

لا توجد واجهة برمجة تطبيقات مدمجة للعمليات البوليانية. يمكنك تقريب ذلك بإنشاء المخطط المطلوب يدويًا—مثلاً حساب الهندسة الناتجة عبر GeometryPath وإنشاء شكل جديد بهذا الحد، مع إمكانية حذف الأشكال الأصلية.

كيف يمكنني التحكم في ترتيب الطبقات (z-order) بحيث يبقى الشكل دائمًا “في القمة”?

غيّر ترتيب الإدراج/النقل داخل مجموعة shapes للشفرة. للحصول على نتائج متوقعة، قم بتحديد ترتيب z بعد إتمام جميع التعديلات الأخرى على الشريحة.

هل يمكنني “قفل” الشكل لمنع المستخدمين من تحريره في PowerPoint؟

نعم. عيّن أعلام الحماية على مستوى الشكل [/slides/python-net/applying-protection-to-presentation/] (مثل قفل التحديد، الحركة، تغيير الحجم، تحرير النص). إذا لزم الأمر، طبق قيودًا مماثلة على القالب أو التخطيط. لاحظ أن هذه الحماية على مستوى واجهة المستخدم فقط، وليست ميزة أمان؛ للحصول على حماية أقوى، يمكن دمجها مع قيود على مستوى الملف مثل التوصيات للقراءة فقط أو كلمات المرور [/slides/python-net/password-protected-presentation/].