إدارة أدلة الرسم في العروض التقديمية على Android

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

إضافة، والوصول إلى، ومسح أدلة الرسم الأفقية والعمودية في عروض PowerPoint التقديمية باستخدام Aspose.Slides لنظام Android عبر Java.

نظرة عامة

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

دليل الرسم هو أداة تحرير، ليس محتوى شريحة. لا تظهر في عرض الشرائح أو الإخراج المُصوَّر. تُظهر Aspose.Slides for Android عبر Java هذه الأدوات من خلال الواجهة IDrawingGuidesCollection. يُمثَّل الدليل بواسطة IDrawingGuide ويحتوي على اتجاه وموقع ولون.

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

إضافة أدلة إلى عرض الشريحة

استخدم ICommonSlideViewProperties.getDrawingGuides لإدارة الأدلة المعروضة أثناء تحرير الشرائح العادية. استدعِ IDrawingGuidesCollection.add مع قيمة Orientation وموقع بوحدات النقاط.

المثال التالي يضيف دليلًا عموديًا واحدًا إلى يمين مركز الشريحة ودليلًا أفقيًا أسفله:

import com.aspose.slides.*;
import com.aspose.slides.android.SizeF;

Presentation presentation = new Presentation();
try {
    SizeF slideSize = presentation.getSlideSize().getSize();
    IDrawingGuidesCollection guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    guides.add(Orientation.Vertical, slideSize.getWidth() / 2 + 12.5f);
    guides.add(Orientation.Horizontal, slideSize.getHeight() / 2 + 12.5f);

    presentation.save("drawing-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

الوصول إلى أدلة الرسم

توفر طُرُق IDrawingGuidesCollection.getCount و IDrawingGuidesCollection.get_Item إمكانية الوصول إلى الأدلة الموجودة. تُعيد طُرُق IDrawingGuide.getOrientation، IDrawingGuide.getPosition، و IDrawingGuide.getColor قيمًا يمكن أيضًا تعديلها عبر طُرُق الضبط المقابلة.

المثال التالي يقرأ أدلة عرض الشريحة من العرض التقديمي الذي تم إنشاؤه أعلاه:

import com.aspose.slides.*;

Presentation presentation = new Presentation("drawing-guides.pptx");
try {
    IDrawingGuidesCollection guides = presentation.getViewProperties().getSlideViewProperties().getDrawingGuides();

    for (int index = 0; index < guides.getCount(); index++) {
        IDrawingGuide guide = guides.get_Item(index);
        System.out.println("Guide " + index + ": orientation = " + guide.getOrientation() + ", position = " + guide.getPosition() + ", color = " + guide.getColor());
    }
} finally {
    presentation.dispose();
}

إضافة أدلة إلى القوالب وعروض التخطيط

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

المثال التالي يضيف دليلًا عموديًا إلى أول شريحة قالب ودليلًا أفقيًا إلى أول شريحة تخطيط:

import com.aspose.slides.*;
import com.aspose.slides.android.SizeF;

Presentation presentation = new Presentation();
try {
    SizeF slideSize = presentation.getSlideSize().getSize();
    IDrawingGuidesCollection masterGuides = presentation.getMasters().get_Item(0).getDrawingGuides();
    IDrawingGuidesCollection layoutGuides = presentation.getLayoutSlides().get_Item(0).getDrawingGuides();

    masterGuides.add(Orientation.Vertical, slideSize.getWidth() / 2 - 20);
    layoutGuides.add(Orientation.Horizontal, slideSize.getHeight() / 2 + 20);

    presentation.save("master-layout-drawing-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

إضافة أدلة إلى قوالب الملاحظات والنشرات

تدعم قوالب الملاحظات وقوالب النشرات أيضًا أدلة الرسم. استخدم IMasterNotesSlide.getDrawingGuides و IMasterHandoutSlide.getDrawingGuides للوصول إلى مجموعاتهم. إذا لم يحتوي العرض التقديمي على أحد هذه القوالب، فإن IMasterNotesSlideManager.setDefaultMasterNotesSlide أو IMasterHandoutSlideManager.setDefaultMasterHandoutSlide يقوم بإنشاء القالب الافتراضي ويعيده.

المثال التالي يضيف دليلًا أفقيًا إلى قالب ملاحظات ودليلًا عموديًا إلى قالب نشرة:

import com.aspose.slides.*;
import com.aspose.slides.android.SizeF;

Presentation presentation = new Presentation();
try {
    SizeF notesSize = presentation.getNotesSize().getSize();
    IMasterNotesSlide notesMaster = presentation.getMasterNotesSlideManager().setDefaultMasterNotesSlide();
    IMasterHandoutSlide handoutMaster = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();

    notesMaster.getDrawingGuides().add(Orientation.Horizontal, notesSize.getHeight() / 2 + 50);
    handoutMaster.getDrawingGuides().add(Orientation.Vertical, notesSize.getWidth() / 2 - 50);

    presentation.save("notes-handout-drawing-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

مسح أدلة الرسم

استدعِ IDrawingGuidesCollection.clear لإزالة كل دليل من مجموعة معينة. مسح مجموعة واحدة لا يؤثر على الأدلة المخزنة في نطاق آخر.

المثال التالي يمسح أدلة عرض الشريحة وجميع الأدلة على قوالب الشرائح، شرائح التخطيط، قالب الملاحظات، وقالب النشرة دون إنشاء القوالب المفقودة:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation-with-guides.pptx");
try {
    presentation.getViewProperties().getSlideViewProperties().getDrawingGuides().clear();

    for (IMasterSlide masterSlide : presentation.getMasters()) {
        masterSlide.getDrawingGuides().clear();
    }

    for (ILayoutSlide layoutSlide : presentation.getLayoutSlides()) {
        layoutSlide.getDrawingGuides().clear();
    }

    IMasterNotesSlide notesMaster = presentation.getMasterNotesSlideManager().getMasterNotesSlide();
    if (notesMaster != null) {
        notesMaster.getDrawingGuides().clear();
    }

    IMasterHandoutSlide handoutMaster = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();
    if (handoutMaster != null) {
        handoutMaster.getDrawingGuides().clear();
    }

    presentation.save("presentation-without-guides.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

الأسئلة المتداولة

هل تظهر أدلة الرسم في عرض الشرائح أو الصور المصدَّرة؟
لا. أدلة الرسم هي أدوات محاذاة للتعديل ولا تُعرض كجزء من محتوى العرض.

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

ما الوحدات المستخدمة لمواقع الأدلة؟
يتم تحديد المواقع بوحدات النقاط، حيث 72 نقطة تساوي بوصة واحدة. تُقاس المواقع الرأسية من الحافة اليسرى، وتُقاس المواقع الأفقية من الحافة العلوية.

هل يؤدي مسح أدلة الرسم إلى إزالة الأشكال أو تغيير محتوى الشريحة؟
لا. تُزيل طريقة IDrawingGuidesCollection.clear فقط الأدلة في المجموعة المختارة. تبقى الأشكال ومحتوى الشريحة الآخر دون تغيير.