จัดการส่วนหัวและส่วนท้ายของการนำเสนอใน Python ผ่าน Java

Overview

PowerPoint ใช้ตัวเติมหัวกระดาษและท้ายกระดาษที่แตกต่างกันตามประเภทของหน้า Aspose.Slides for Python via Java ให้คุณควบคุมข้อความและการมองเห็นของตัวเติมเหล่านี้ผ่านคลาสผู้จัดการหัวกระดาษ/ท้ายกระดาษ

ตัวเติมที่มีให้ใช้ขึ้นอยู่กับขอบเขต:

Scope Header Footer Date/time Slide/page number
Regular slide No Yes Yes Yes
Notes master Yes Yes Yes Yes
Notes slide Yes Yes Yes Yes
Handout master Yes Yes Yes Yes

สไลด์นำเสนอปกติไม่มีตัวเติมหัวกระดาษ หัวกระดาษจะปรากฏบนหน้าบันทึกและเอกสารแจกมือ สำหรับสไลด์ปกติให้ใช้ตัวเติมท้ายกระดาษ, วันที่/เวลา, และหมายเลขสไลด์แทน

ขอบเขตของการเปลี่ยนแปลงขึ้นอยู่กับผู้จัดการที่คุณใช้ คลาส SlideHeaderFooterManager ควบคุมสไลด์ปกติหนึ่งสไลด์ คลาส NotesSlideHeaderFooterManager ควบคุมสไลด์บันทึกหนึ่งสไลด์ ผู้จัดการมาสเตอร์และเลย์เอาต์ยังสามารถกระจายการตั้งค่าให้กับสไลด์ที่ขึ้นกับได้ ในขณะที่คลาส MasterHandoutSlideHeaderFooterManager ควบคุมมาสเตอร์เอกสารแจกมือ

สำหรับสไลด์ปกติ กระบวนการพื้นฐานคือเข้าถึงผู้จัดการหัวกระดาษ/ท้ายกระดาษของแต่ละสไลด์ ตั้งข้อความท้ายกระดาษและวันที่/เวลา เปิดใช้งานตัวเติมที่ต้องการ แล้วบันทึกการนำเสนอ หมายเลขสไลด์สร้างโดยการนำเสนอเอง ดังนั้นคุณเพียงแค่ควบคุมการมองเห็นของมัน

ใช้ setFooterText และ setDateTimeText เพื่อกำหนดข้อความ และใช้ setFooterVisibility, setDateTimeVisibility และ setSlideNumberVisibility เพื่อแสดงตัวเติมที่สอดคล้องกัน

ตัวอย่างต่อไปนี้เป็นการประมวลผลแบบครบวงจร ที่ใช้ท้ายกระดาษ, ข้อความวันที่/เวลา, และการมองเห็นหมายเลขสไลด์เดียวกันกับสไลด์ปกติทั้งหมด:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    for slide in presentation.getSlides():
        header_footer_manager = slide.getHeaderFooterManager()

        header_footer_manager.setFooterText("Company Confidential")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_slide_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

หากต้องการอัปเดตเพียงสไลด์เดียว ให้เข้าถึงสไลด์นั้นโดยตรงผ่านเมธอด getSlides แทนการวนลูปผ่านคอลเลกชันทั้งหมด

Set Headers and Footers on the Notes Master

มาสเตอร์บันทึกกำหนดรูปแบบทั่วไปและพฤติกรรมของตัวเติมสำหรับหน้าบันทึก ใช้คลาส MasterNotesSlideHeaderFooterManager เมื่อคุณต้องการเปลี่ยนแปลงเฉพาะมาสเตอร์บันทึกเท่านั้น

ตัวอย่างต่อไปนี้ตั้งหัวกระดาษ, ท้ายกระดาษ, และข้อความวันที่/เวลา บนมาสเตอร์บันทึกและทำให้ตัวเติมที่รองรับทั้งหมดมองเห็นได้บนมาสเตอร์นั้น:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()

    if master_notes_slide is not None:
        header_footer_manager = master_notes_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderText("Notes header")
        header_footer_manager.setHeaderVisibility(True)

        header_footer_manager.setFooterText("Notes footer")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_notes_master_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

เมธอด getMasterNotesSlide จะคืนค่า None หากการนำเสนอไม่มีมาสเตอร์บันทึก

Apply Notes Master Settings to Child Notes Slides

มาสเตอร์บันทึกสามารถนำการตั้งค่าหัวกระดาษและท้ายกระดาษไปใช้กับตนเองและสไลด์บันทึกที่ขึ้นกับทั้งหมด ใช้เมธอดการกระจายเฉพาะบน MasterNotesSlideHeaderFooterManager เมื่อต้องการให้การตั้งค่าเดียวกันถูกนำไปใช้ทั่วทั้งลำดับบันทึก

เช่นเมธอด setHeaderAndChildHeadersText และ setHeaderAndChildHeadersVisibility จะอัปเดตหัวกระดาษของมาสเตอร์บันทึกและหัวกระดาษของสไลด์ลูกทั้งหมด เมธอดที่เทียบเท่ามีให้สำหรับท้ายกระดาษ, วันที่/เวลา, และหมายเลขสไลด์

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_notes_slide = presentation.getMasterNotesSlideManager().getMasterNotesSlide()

    if master_notes_slide is not None:
        header_footer_manager = master_notes_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderAndChildHeadersText("Notes header")
        header_footer_manager.setHeaderAndChildHeadersVisibility(True)

        header_footer_manager.setFooterAndChildFootersText("Notes footer")
        header_footer_manager.setFooterAndChildFootersVisibility(True)

        header_footer_manager.setDateTimeAndChildDateTimesText("Date and time text")
        header_footer_manager.setDateTimeAndChildDateTimesVisibility(True)

        header_footer_manager.setSlideNumberAndChildSlideNumbersVisibility(True)

    presentation.save("presentation_with_child_notes_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

เมธอดการกระจายที่ใช้ด้านบนคือ setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility, และ setSlideNumberAndChildSlideNumbersVisibility

Set Headers and Footers on an Individual Notes Slide

สไลด์บันทึกเป็นส่วนของสไลด์ปกติหนึ่งสไลด์ ใช้คลาส NotesSlideHeaderFooterManager เมื่อคุณต้องการปรับแต่งเพียงหน้าบันทึกนั้นเท่านั้น

เมธอด addNotesSlide คืนค่าสไลด์บันทึกสำหรับสไลด์ปัจจุบันและสร้างขึ้นใหม่หากยังไม่มี ตัวอย่างต่อไปนี้กำหนดค่าหน้าบันทึกที่เชื่อมกับสไลด์แรกของการนำเสนอ:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    notes_slide = slide.getNotesSlideManager().addNotesSlide()
    header_footer_manager = notes_slide.getHeaderFooterManager()

    header_footer_manager.setHeaderText("Header for the first notes page")
    header_footer_manager.setHeaderVisibility(True)

    header_footer_manager.setFooterText("Footer for the first notes page")
    header_footer_manager.setFooterVisibility(True)

    header_footer_manager.setDateTimeText("Date and time text")
    header_footer_manager.setDateTimeVisibility(True)

    header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_custom_notes_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

หากคุณกระจายการตั้งค่าจากมาสเตอร์บันทึกก่อน แล้วจึงเปลี่ยนสไลด์บันทึกแต่ละอัน การตั้งค่าตามสไลด์ในภายหลังจะทำให้คุณปรับแต่งหน้าบันทึกนั้นได้อย่างอิสระ

Set Headers and Footers on the Handout Master

หน้ากระดาษแจกมือใช้มาสเตอร์เอกสารแจกมือสำหรับตัวเติมหัวกระดาษ, ท้ายกระดาษ, วันที่/เวลา, และหมายเลขหน้า ต่างจากหน้าบันทึก การตั้งค่าเอกสารแจกมือจัดการผ่านมาสเตอร์เอกสารแจกมือ ไม่ใช่ผ่านสไลด์เอกสารแจกมือแยกแต่ละอัน

ใช้เมธอด getMasterHandoutSlide เพื่อเข้าถึงมาสเตอร์เอกสารแจกมือ หากไม่มี ให้เรียก setDefaultMasterHandoutSlide เพื่อสร้างมาสเตอร์เอกสารแจกมือเริ่มต้น

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    master_handout_slide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide()

    if master_handout_slide is None:
        master_handout_slide = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide()

    if master_handout_slide is not None:
        header_footer_manager = master_handout_slide.getHeaderFooterManager()

        header_footer_manager.setHeaderText("Handout header")
        header_footer_manager.setHeaderVisibility(True)

        header_footer_manager.setFooterText("Handout footer")
        header_footer_manager.setFooterVisibility(True)

        header_footer_manager.setDateTimeText("Date and time text")
        header_footer_manager.setDateTimeVisibility(True)

        header_footer_manager.setSlideNumberVisibility(True)

    presentation.save("presentation_with_handout_footers.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Understand Scope and Inheritance

เลือกผู้จัดการหัวกระดาษ/ท้ายกระดาษที่ตรงกับขอบเขตที่คุณต้องการเปลี่ยนแปลง:

  • SlideHeaderFooterManager เปลี่ยนการตั้งค่าท้ายกระดาษ, วันที่/เวลา, และหมายเลขสไลด์สำหรับสไลด์ปกติหนึ่งสไลด์
  • LayoutSlideHeaderFooterManager ควบคุมสไลด์เลย์เอาต์และสามารถกระจายการตั้งค่าที่รองรับไปยังสไลด์ที่ขึ้นกับได้
  • MasterSlideHeaderFooterManager ควบคุมมาสเตอร์สไลด์ปกติและสามารถกระจายการตั้งค่าที่รองรับไปยังสไลด์ที่ขึ้นกับได้
  • MasterNotesSlideHeaderFooterManager ควบคุมมาสเตอร์บันทึกและสามารถกระจายการตั้งค่าไปยังสไลด์บันทึกที่ขึ้นกับทั้งหมด
  • NotesSlideHeaderFooterManager เปลี่ยนสไลด์บันทึกหนึ่งสไลด์และสนับสนุนตัวเติมหัวกระดาษนอกเหนือจากท้ายกระดาษ, วันที่/เวลา, และหมายเลขสไลด์
  • MasterHandoutSlideHeaderFooterManager เปลี่ยนมาสเตอร์เอกสารแจกมือและสนับสนุนตัวเติมสี่ประเภททั้งหมด

ใช้การกระจายจากมาสเตอร์หรือเลย์เอาต์เมื่อการตั้งค่าเดียวกันควรใช้ทั่วทั้งลำดับชั้น ใช้ผู้จัดการสไลด์หรือสไลด์บันทึกแบบแยกเมื่อคุณต้องการการตั้งค่าท้องถิ่นสำหรับหนึ่งหน้า

FAQ

Can I add a header to a regular slide?

No. PowerPoint does not define a header placeholder for regular slides. On regular slides, use the footer, date/time, and slide-number placeholders. Header placeholders are available on notes pages and handouts.

What if a footer, date/time, or slide-number placeholder is not visible?

Use the corresponding header/footer manager to check its visibility and enable it when needed. For example, isFooterVisible reports whether a footer placeholder is present, and setFooterVisibility changes its visibility.

How do I start slide numbering from a value other than 1?

Call the presentation’s setFirstSlideNumber method. The slide-number placeholders then use the updated numbering sequence.

What happens to headers and footers when exporting to PDF, images, or HTML?

Visible header and footer elements are rendered with the rest of the presentation content in the output format. Their appearance depends on the page type being exported and the corresponding placeholder visibility settings.

ควบคุมฟอนต์ PowerPoint ใน Python ผ่าน Java