إدارة رؤوس وتذييلات العرض التقديمي في PHP

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

تعلم كيفية إدارة عناصر النائب للتذييل، التاريخ-الوقت، رقم الشريحة، والترويس على الشرائح، صفحات الملاحظات، والنشرات باستخدام Aspose.Slides للـ PHP عبر Java.

نظرة عامة

يستخدم PowerPoint عناصر نائب مختلفة للترويس والتذييل اعتمادًا على نوع الصفحة. يتيح Aspose.Slides for PHP عبر Java التحكم في النص ورؤية هذه العناصر النائبة من خلال فئات مدير الترويس/التذييل.

تختلف العناصر النائبة المتاحة بحسب النطاق:

النطاق	الترويس	التذييل	التاريخ/الوقت	رقم الشريحة/الصفحة
شريحة عادية	لا	نعم	نعم	نعم
قالب ملاحظات أساسي	نعم	نعم	نعم	نعم
شريحة ملاحظات	نعم	نعم	نعم	نعم
قالب النسخة المطبوعة أساسي	نعم	نعم	نعم	نعم

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

يعتمد نطاق التغيّر على المدير الذي تستخدمه. تتحكم الفئة SlideHeaderFooterManager في شريحة عادية واحدة. تتحكم الفئة NotesSlideHeaderFooterManager في شريحة ملاحظات واحدة. يمكن لمديري القالب والتخطيط أيضًا نشر الإعدادات إلى الشرائح التابعة، بينما تتحكم الفئة MasterHandoutSlideHeaderFooterManager في قالب النسخة المطبوعة.

تعيين التذييل، التاريخ/الوقت، وأرقام الشرائح على الشرائح العادية

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

استخدم setFooterText وsetDateTimeText لتعيين النص، واستخدم setFooterVisibility، setDateTimeVisibility، وsetSlideNumberVisibility لإظهار العناصر النائبة المقابلة.

المثال التالي يطبق نفس التذييل، نص التاريخ/الوقت، ورؤية رقم الشريحة على جميع الشرائح العادية:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    foreach ($presentation->getSlides() as $slide) {
        $headerFooterManager = $slide->getHeaderFooterManager();

        $headerFooterManager->setFooterText("Company Confidential");
        $headerFooterManager->setFooterVisibility(true);

        $headerFooterManager->setDateTimeText("Date and time text");
        $headerFooterManager->setDateTimeVisibility(true);

        $headerFooterManager->setSlideNumberVisibility(true);
    }

    $presentation->save("presentation_with_slide_footers.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

إذا كنت تحتاج إلى تعديل شريحة واحدة فقط، يمكنك الوصول إلى تلك الشريحة مباشرة عبر طريقة getSlides بدلاً من التكرار عبر المجموعة بالكامل.

تعيين الترويس والتذييل على قالب ملاحظات أساسي

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

المثال التالي يعيّن الترويس، التذييل، ونص التاريخ/الوقت على قالب الملاحظات ويجعل جميع العناصر النائبة المدعومة مرئية على ذلك القالب:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    $masterNotesSlide = $presentation->getMasterNotesSlideManager()->getMasterNotesSlide();

    if (!java_is_null($masterNotesSlide)) {
        $headerFooterManager = $masterNotesSlide->getHeaderFooterManager();

        $headerFooterManager->setHeaderText("Notes header");
        $headerFooterManager->setHeaderVisibility(true);

        $headerFooterManager->setFooterText("Notes footer");
        $headerFooterManager->setFooterVisibility(true);

        $headerFooterManager->setDateTimeText("Date and time text");
        $headerFooterManager->setDateTimeVisibility(true);

        $headerFooterManager->setSlideNumberVisibility(true);
    }

    $presentation->save("presentation_with_notes_master_footers.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

طريقة getMasterNotesSlide تُعيد null عندما لا يحتوي العرض على قالب ملاحظات أساسي.

تطبيق إعدادات قالب الملاحظات على شرائح الملاحظات التابعة

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

على سبيل المثال، تقوم كل من setHeaderAndChildHeadersText وsetHeaderAndChildHeadersVisibility بتحديث ترويس قالب الملاحظات وجميع الترويسات التابعة. تتوفر أساليب مماثلة للتذييل، التاريخ/الوقت، وأرقام الشرائح.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    $masterNotesSlide = $presentation->getMasterNotesSlideManager()->getMasterNotesSlide();

    if (!java_is_null($masterNotesSlide)) {
        $headerFooterManager = $masterNotesSlide->getHeaderFooterManager();

        $headerFooterManager->setHeaderAndChildHeadersText("Notes header");
        $headerFooterManager->setHeaderAndChildHeadersVisibility(true);

        $headerFooterManager->setFooterAndChildFootersText("Notes footer");
        $headerFooterManager->setFooterAndChildFootersVisibility(true);

        $headerFooterManager->setDateTimeAndChildDateTimesText("Date and time text");
        $headerFooterManager->setDateTimeAndChildDateTimesVisibility(true);

        $headerFooterManager->setSlideNumberAndChildSlideNumbersVisibility(true);
    }

    $presentation->save("presentation_with_child_notes_footers.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

أساليب النشر المستخدمة أعلاه هي setFooterAndChildFootersText، setFooterAndChildFootersVisibility، setDateTimeAndChildDateTimesText، setDateTimeAndChildDateTimesVisibility، وsetSlideNumberAndChildSlideNumbersVisibility.

تعيين الترويس والتذييل على شريحة ملاحظات فردية

تنتمي شريحة الملاحظات إلى شريحة عادية محددة. استخدم فئة NotesSlideHeaderFooterManager عندما تريد تخصيص تلك الصفحة الملاحظة فقط.

طريقة addNotesSlide تُعيد شريحة الملاحظات للشريحة الحالية وتُنشئ واحدة إذا لم تكن موجودة مسبقًا. المثال التالي يكوّن صفحة الملاحظات المرتبطة بأول شريحة في العرض:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $notesSlide = $slide->getNotesSlideManager()->addNotesSlide();
    $headerFooterManager = $notesSlide->getHeaderFooterManager();

    $headerFooterManager->setHeaderText("Header for the first notes page");
    $headerFooterManager->setHeaderVisibility(true);

    $headerFooterManager->setFooterText("Footer for the first notes page");
    $headerFooterManager->setFooterVisibility(true);

    $headerFooterManager->setDateTimeText("Date and time text");
    $headerFooterManager->setDateTimeVisibility(true);

    $headerFooterManager->setSlideNumberVisibility(true);

    $presentation->save("presentation_with_custom_notes_footers.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

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

تعيين الترويس والتذييل على قالب النسخة المطبوعة

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

استخدم طريقة getMasterHandoutSlide للوصول إلى قالب النسخة المطبوعة. إذا لم يكن موجودًا، استدعِ setDefaultMasterHandoutSlide لإنشاء القالب الافتراضي.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("presentation.pptx");
try {
    $masterHandoutSlide = $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide();

    if (java_is_null($masterHandoutSlide)) {
        $masterHandoutSlide = $presentation->getMasterHandoutSlideManager()->setDefaultMasterHandoutSlide();
    }

    if (!java_is_null($masterHandoutSlide)) {
        $headerFooterManager = $masterHandoutSlide->getHeaderFooterManager();

        $headerFooterManager->setHeaderText("Handout header");
        $headerFooterManager->setHeaderVisibility(true);

        $headerFooterManager->setFooterText("Handout footer");
        $headerFooterManager->setFooterVisibility(true);

        $headerFooterManager->setDateTimeText("Date and time text");
        $headerFooterManager->setDateTimeVisibility(true);

        $headerFooterManager->setSlideNumberVisibility(true);
    }

    $presentation->save("presentation_with_handout_footers.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

فهم النطاق والوراثة

اختر مدير الترويس/التذييل الذي يتطابق مع النطاق الذي تريد تغييره:

• SlideHeaderFooterManager يغيّر إعدادات التذييل، التاريخ/الوقت، ورقم الشريحة لشريحة عادية واحدة.
• LayoutSlideHeaderFooterManager يتحكم في شريحة تخطيط ويمكنه نشر الإعدادات المدعومة إلى الشرائح التابعة.
• MasterSlideHeaderFooterManager يتحكم في قالب شريحة عادية ويمكنه نشر الإعدادات المدعومة إلى الشرائح التابعة.
• MasterNotesSlideHeaderFooterManager يتحكم في قالب الملاحظات ويمكنه نشر الإعدادات إلى جميع شرائح الملاحظات التابعة.
• NotesSlideHeaderFooterManager يغيّر شريحة ملاحظات واحدة ويدعم عنصر نائب للترويس بالإضافة إلى التذييل، التاريخ/الوقت، ورقم الشريحة.
• MasterHandoutSlideHeaderFooterManager يغيّر قالب النسخة المطبوعة ويدعم جميع أنواع العناصر النائبة الأربعة.

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

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

هل يمكنني إضافة ترويس إلى شريحة عادية؟

لا. لا يحدد PowerPoint عنصرًا نائبًا للترويس في الشرائح العادية. في الشرائح العادية، استخدم عناصر التذييل، التاريخ/الوقت، ورقم الشريحة. تتوفر عناصر الترويس في صفحات الملاحظات والنسخ المطبوعة.

ماذا يحدث إذا لم يكن عنصر التذييل أو التاريخ/الوقت أو رقم الشريحة مرئيًا؟

استخدم مدير الترويس/التذييل المقابل للتحقق من رؤيته وتمكينه عند الحاجة. على سبيل المثال، تُبلغ طريقة isFooterVisible ما إذا كان عنصر التذييل موجودًا، وتُغيّر طريقة setFooterVisibility رؤيته.

كيف أبدأ ترقيم الشرائح من قيمة غير 1؟

استدعِ طريقة setFirstSlideNumber في العرض. ثم تستخدم عناصر رقم الشريحة التسلسل المحدث.

ماذا يحدث للترويسات والتذييلات عند التصدير إلى PDF أو صور أو HTML؟

يتم عرض عناصر الترويس والتذييل المرئية مع باقي محتوى العرض في صيغة الإخراج. يعتمد مظهرها على نوع الصفحة المُصدَّر وإعدادات رؤية العناصر النائبة المقابلة.