JavaScript에서 프레젠테이션 머리글 및 바닥글 관리

이 페이지의 내용

Aspose.Slides for Node.js via Java를 사용하여 슬라이드, 노트 페이지 및 유인물에서 바닥글, 날짜/시간, 슬라이드 번호 및 머리글 자리표시자를 관리하는 방법을 배웁니다.

개요

PowerPoint는 페이지 유형에 따라 다른 머리글 및 바닥글 자리표시자를 사용합니다. Aspose.Slides for Node.js via Java를 사용하면 머리글/바닥글 관리자 클래스를 통해 이러한 자리표시자의 텍스트와 표시 여부를 제어할 수 있습니다.

사용 가능한 자리표시자는 범위에 따라 달라집니다:

범위	머리글	바닥글	날짜/시간	슬라이드/페이지 번호
일반 슬라이드	없음	예	예	예
노트 마스터	예	예	예	예
노트 슬라이드	예	예	예	예
유인물 마스터	예	예	예	예

일반 프레젠테이션 슬라이드에는 머리글 자리표시자가 없습니다. 머리글은 노트 페이지와 유인물에서 사용할 수 있습니다. 일반 슬라이드에서는 바닥글, 날짜/시간 및 슬라이드 번호 자리표시자를 대신 사용하십시오.

변경 범위는 사용하는 관리자에 따라 달라집니다. SlideHeaderFooterManager 클래스는 하나의 일반 슬라이드를 제어합니다. NotesSlideHeaderFooterManager 클래스는 하나의 노트 슬라이드를 제어합니다. 마스터 및 레이아웃 관리자는 종속 슬라이드에 설정을 전파할 수 있으며, MasterHandoutSlideHeaderFooterManager 클래스는 유인물 마스터를 제어합니다.

일반 슬라이드에 바닥글, 날짜/시간 및 슬라이드 번호 설정

일반 슬라이드의 기본 워크플로는 각 슬라이드의 머리글/바닥글 관리자에 접근해 바닥글과 날짜/시간 텍스트를 설정하고 필요한 자리표시자를 활성화한 뒤 프레젠테이션을 저장하는 것입니다. 슬라이드 번호는 프레젠테이션이 자동으로 생성하므로 표시 여부만 제어하면 됩니다.

텍스트를 설정하려면 setFooterText와 setDateTimeText를 사용하고, 해당 자리표시자를 표시하려면 setFooterVisibility, setDateTimeVisibility, setSlideNumberVisibility를 사용하십시오.

다음은 모든 일반 슬라이드에 동일한 바닥글, 날짜/시간 텍스트 및 슬라이드 번호 표시를 적용하는 전체 예제입니다:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        const slide = presentation.getSlides().get_Item(i);
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

하나의 슬라이드만 업데이트하려면 전체 컬렉션을 반복하는 대신 getSlides 메서드로 해당 슬라이드에 직접 접근하십시오.

노트 마스터에 머리글 및 바닥글 설정

노트 마스터는 노트 페이지에 대한 공통 서식 및 자리표시자 동작을 정의합니다. 노트 마스터 자체만 변경하려면 MasterNotesSlideHeaderFooterManager 클래스를 사용하십시오.

다음 예제는 노트 마스터에 머리글, 바닥글 및 날짜/시간 텍스트를 설정하고 해당 마스터에서 지원되는 모든 자리표시자를 표시합니다:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    const masterNotesSlide = presentation.getMasterNotesSlideManager().getMasterNotesSlide();

    if (masterNotesSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

프레젠테이션에 노트 마스터가 포함되어 있지 않으면 getMasterNotesSlide 메서드는 null을 반환합니다.

노트 마스터 설정을 하위 노트 슬라이드에 적용

노트 마스터는 자체와 모든 종속 노트 슬라이드에 머리글 및 바닥글 설정을 적용할 수 있습니다. 동일한 설정을 노트 계층 전체에 적용하려면 MasterNotesSlideHeaderFooterManager 의 전파 전용 메서드를 사용하십시오.

예를 들어, setHeaderAndChildHeadersText와 setHeaderAndChildHeadersVisibility 메서드는 노트 마스터 머리글과 모든 하위 머리글을 업데이트합니다. 바닥글, 날짜/시간 및 슬라이드 번호에 대해서도 동일한 메서드가 제공됩니다.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    const masterNotesSlide = presentation.getMasterNotesSlideManager().getMasterNotesSlide();

    if (masterNotesSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

위에서 사용된 전파 메서드는 setFooterAndChildFootersText, setFooterAndChildFootersVisibility, setDateTimeAndChildDateTimesText, setDateTimeAndChildDateTimesVisibility, 그리고 setSlideNumberAndChildSlideNumbersVisibility 입니다.

개별 노트 슬라이드에 머리글 및 바닥글 설정

노트 슬라이드는 특정 일반 슬라이드에 속합니다. 해당 노트 페이지만 커스터마이즈하려면 NotesSlideHeaderFooterManager 클래스를 사용하십시오.

addNotesSlide 메서드는 현재 슬라이드에 대한 노트 슬라이드를 반환하고, 존재하지 않을 경우 새로 생성합니다. 다음 예제는 첫 번째 프레젠테이션 슬라이드와 연결된 노트 페이지를 구성합니다:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const headerFooterManager = slide.getNotesSlideManager().addNotesSlide().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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

먼저 노트 마스터에서 설정을 전파한 뒤 개별 노트 슬라이드를 변경하면, 이후 슬라이드별 설정이 해당 노트 페이지를 독립적으로 커스터마이즈하도록 합니다.

유인물 마스터에 머리글 및 바닥글 설정

유인물 페이지는 유인물 마스터를 사용해 머리글, 바닥글, 날짜/시간 및 페이지 번호 자리표시자를 관리합니다. 노트 페이지와 달리 유인물 설정은 개별 유인물 슬라이드가 아니라 유인물 마스터를 통해 관리됩니다.

유인물 마스터에 접근하려면 getMasterHandoutSlide 를 사용하십시오. 마스터가 없으면 setDefaultMasterHandoutSlide 를 호출해 기본 유인물 마스터를 생성합니다.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("presentation.pptx");
try {
    let masterHandoutSlide = presentation.getMasterHandoutSlideManager().getMasterHandoutSlide();

    if (masterHandoutSlide === null) {
        masterHandoutSlide = presentation.getMasterHandoutSlideManager().setDefaultMasterHandoutSlide();
    }

    if (masterHandoutSlide !== null) {
        const 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", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

범위 및 상속 이해하기

변경하려는 범위에 맞는 머리글/바닥글 관리자를 선택하십시오:

SlideHeaderFooterManager 은 하나의 일반 슬라이드에 대한 바닥글, 날짜/시간 및 슬라이드 번호 설정을 변경합니다.
LayoutSlideHeaderFooterManager 은 레이아웃 슬라이드를 제어하며 지원되는 설정을 종속 슬라이드에 전파할 수 있습니다.
MasterSlideHeaderFooterManager 은 일반 슬라이드 마스터를 제어하고 지원되는 설정을 종속 슬라이드에 전파할 수 있습니다.
MasterNotesSlideHeaderFooterManager 은 노트 마스터를 제어하고 모든 종속 노트 슬라이드에 설정을 전파합니다.
NotesSlideHeaderFooterManager 은 하나의 노트 슬라이드를 변경하며 머리글 자리표시자를 포함한 바닥글, 날짜/시간 및 슬라이드 번호를 지원합니다.
MasterHandoutSlideHeaderFooterManager 은 유인물 마스터를 변경하고 네 가지 자리표시자 유형을 모두 지원합니다.

동일한 설정을 계층 전체에 적용하려면 마스터나 레이아웃에서 전파를 사용하십시오. 하나의 페이지에만 로컬 설정이 필요하면 개별 슬라이드 또는 노트 슬라이드 관리자를 사용하십시오.

FAQ

일반 슬라이드에 머리글을 추가할 수 있나요?

아닙니다. PowerPoint는 일반 슬라이드에 머리글 자리표시자를 정의하지 않습니다. 일반 슬라이드에서는 바닥글, 날짜/시간 및 슬라이드 번호 자리표시자를 사용하십시오. 머리글 자리표시자는 노트 페이지와 유인물에서만 사용할 수 있습니다.

바닥글, 날짜/시간 또는 슬라이드 번호 자리표시자가 보이지 않으면 어떻게 해야 하나요?

해당 머리글/바닥글 관리자를 사용해 표시 여부를 확인하고 필요할 때 활성화하십시오. 예를 들어, isFooterVisible 은 바닥글 자리표시자가 존재하는지 여부를 반환하며, setFooterVisibility 은 표시 여부를 변경합니다.

슬라이드 번호를 1이 아닌 다른 값부터 시작하려면 어떻게 해야 하나요?

프레젠테이션의 setFirstSlideNumber 메서드를 호출하십시오. 그러면 슬라이드 번호 자리표시자가 업데이트된 번호 순서를 사용합니다.

PDF, 이미지 또는 HTML로 내보낼 때 머리글 및 바닥글은 어떻게 처리되나요?

보이는 머리글 및 바닥글 요소는 출력 형식에서 프레젠테이션 내용과 함께 렌더링됩니다. 표시 여부 설정에 따라 내보내는 페이지 유형에 맞게 표시됩니다.

JavaScript에서 PowerPoint 글꼴 마스터