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

نظرة عامة

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

  • روابط إلى مواقع ويب مدمجة في النص أو الأشكال أو الوسائط
  • روابط إلى الشرائح

تتيح Aspose.Slides for Python via .NET مجموعة واسعة من العمليات المتعلقة بالارتباطات التشعبية في العروض التقديمية.

إضافة ارتباطات URL

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

إضافة ارتباطات URL إلى النص

يظهر مثال الشيفرة التالي كيفية إضافة ارتباط موقع ويب إلى نص:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 600, 50, False)
    shape.add_text_frame("Aspose: File Format APIs")
    
    text_portion = shape.text_frame.paragraphs[0].portions[0]

    text_portion.portion_format.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    text_portion.portion_format.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

إضافة ارتباطات URL إلى الأشكال أو الإطارات

يظهر مثال الشيفرة التالي كيفية إضافة ارتباط موقع ويب إلى شكل:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 600, 50)

    shape.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    shape.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

إضافة ارتباطات URL إلى الوسائط

تتيح Aspose.Slides إضافة ارتباطات إلى الصور، والملفات الصوتية، وملفات الفيديو.

يظهر مثال الشيفرة التالي كيفية إضافة ارتباط إلى صورة:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # أضف صورة إلى العرض التقديمي.
    with open("image.jpeg", "rb") as image_stream:
        image_data = image_stream.read()
        image = presentation.images.add_image(image_data)

    # أنشئ إطار صورة على الشريحة 1 باستخدام الصورة التي تم إضافتها سابقًا.
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, image)

    picture_frame.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    picture_frame.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

يظهر مثال الشيفرة التالي كيفية إضافة ارتباط إلى ملف صوتي:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with open("audio.mp3", "rb") as audio_stream:
        audio_data = audio_stream.read()
        audio = presentation.audios.add_audio(audio_data)
        
    audio_frame = slide.shapes.add_audio_frame_embedded(10, 10, 100, 100, audio)

    audio_frame.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    audio_frame.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

يظهر مثال الشيفرة التالي كيفية إضافة ارتباط إلى فيديو:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with open("video.avi", "rb") as video_stream:
        video_data = video_stream.read()
        video = presentation.videos.add_video(video_data)
        
    video_frame = slide.shapes.add_video_frame(10, 10, 100, 100, video)

    video_frame.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    video_frame.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

استخدام الارتباطات لإنشاء فهرس

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

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

import aspose.slides as slides

with slides.Presentation() as presentation:
    first_slide = presentation.slides[0]
    second_slide = presentation.slides.add_empty_slide(first_slide.layout_slide)

    content_table = first_slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 40, 40, 300, 100)
    content_table.fill_format.fill_type = slides.FillType.NO_FILL
    content_table.line_format.fill_format.fill_type = slides.FillType.NO_FILL
    content_table.text_frame.paragraphs.clear()

    paragraph = slides.Paragraph()
    paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    paragraph.text = "Title of slide 2 .......... "

    link_text_portion = slides.Portion()
    link_text_portion.text = "Page 2"
    link_text_portion.portion_format.hyperlink_manager.set_internal_hyperlink_click(second_slide)

    paragraph.portions.add(link_text_portion)
    content_table.text_frame.paragraphs.add(paragraph)

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

تنسيق الارتباطات التشعبية

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

لون الارتباط التشعبي

باستخدام خاصية color_source من فئة Hyperlink، يمكنك تعيين لون الارتباط وقراءة معلومات لونه. تم تقديم هذه الميزة في PowerPoint 2019، لذا لا تُطبق التغييرات التي تتم عبر هذه الخاصية على الإصدارات الأقدم من PowerPoint.

يُظهر المثال التالي كيفية إضافة ارتباطات بألوان مختلفة إلى نفس الشريحة:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 600, 50, False)
    shape1.add_text_frame("This is a sample of a colored hyperlink.")

    text_portion1 = shape1.text_frame.paragraphs[0].portions[0]
    text_portion1.portion_format.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    text_portion1.portion_format.hyperlink_click.color_source = slides.HyperlinkColorSource.PORTION_FORMAT
    text_portion1.portion_format.fill_format.fill_type = slides.FillType.SOLID
    text_portion1.portion_format.fill_format.solid_fill_color.color = draw.Color.red

    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 200, 450, 50, False)
    shape2.add_text_frame("This is a sample of a regular hyperlink.")

    text_portion2 = shape2.text_frame.paragraphs[0].portions[0]
    text_portion2.portion_format.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")

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

إزالة الارتباطات التشعبية من العروض

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

إزالة الارتباطات التشعبية من النص

يعرض الكود النموذجي التالي كيفية إزالة الارتباطات من النص على شريحة العرض:

import aspose.slides as slides

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

    for shape in slide.shapes:
        if type(shape) is slides.AutoShape:
            for paragraph in shape.text_frame.paragraphs:
                for text_portion in paragraph.portions:
                    text_portion.portion_format.hyperlink_manager.remove_hyperlink_click()

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

إزالة الارتباطات التشعبية من الأشكال أو الإطارات

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

import aspose.slides as slides

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

   for shape in slide.shapes:
       shape.hyperlink_manager.remove_hyperlink_click()

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

الارتباطات القابلة للتعديل

فئة Hyperlink قابلة للتعديل. باستخدام هذه الفئة، يمكنك تغيير قيم الخصائص التالية:

يُظهر مقتطف الشيفرة التالي كيفية إضافة ارتباط إلى شريحة ثم تعديل تلميحه:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 600, 50, False)
    shape.add_text_frame("Aspose: File Format APIs")

    text_portion = shape.text_frame.paragraphs[0].portions[0]
    text_portion.portion_format.hyperlink_click = slides.Hyperlink("https://www.aspose.com/")
    text_portion.portion_format.hyperlink_click.tooltip = "More than 70% of Fortune 100 companies trust Aspose APIs."

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

الخصائص المدعومة في IHyperlinkQueries

يمكنك الوصول إلى HyperlinkQueries من العرض التقديمي أو الشريحة أو النص الذي يحتوي على الارتباط.

تدعم فئة HyperlinkQueries الطرق التالية:

FAQ

كيف يمكنني إنشاء تنقل داخلي ليس فقط إلى شريحة، بل إلى “قسم” أو إلى الشريحة الأولى في قسم؟

الأقسام في PowerPoint هي تجميعات للشرائح؛ التقنية تستهدف شريحة محددة. عادةً ما يتم “التنقل إلى قسم” عبر ربطه بالشريحة الأولى في ذلك القسم.

هل يمكنني إرفاق ارتباط تشعبي لعناصر الشريحة الأم بحيث يعمل على جميع الشرائح؟

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

هل سيتم الحفاظ على الارتباطات التشعبية عند التصدير إلى PDF أو HTML أو صور أو فيديو؟

في PDF وHTML، نعم—عادةً ما تُحافظ على الروابط. عند التصدير إلى صور وفيديو، لا تُنقل القابلية للنقر بسبب طبيعة هذه الصيغ (الإطارات النقطية/الفيديو لا تدعم الارتباطات).

إدارة Blob إدارة ملفات الوسائط