PDF 사용자 정의 헤더와 푸터

문서 렌더링에서 매우 일반적인 작업 중 하나는 페이지 헤더와 푸터를 사용자 정의하여 정적인 텍스트(예: 문서 제목)나 페이지 번호를 추가하는 것입니다. 이 작업을 돕기 위해 PdfDocument 는 이러한 섹션을 선언적으로 구성할 수 있는 방법을 제공합니다.

PdfRunningTitle 은 페이지의 헤더와 푸터를 나타내는 클래스입니다. 이 클래스는 선언적 속성을 제공하며, 그 속성들은 다음과 같습니다:

• text: 실행 중인 제목의 텍스트를 결정합니다.

• brush: 텍스트를 채우는 데 사용되는 브러시를 결정합니다.

• font: 텍스트의 글꼴을 결정합니다.

이 속성들은 PdfDocument 클래스 인스턴스를 생성할 때 정의할 수 있습니다. 문서 렌더링이 완료되면 페이지를 반복하면서 지정된 텍스트가 각 페이지에 주어진 브러시와 글꼴로 추가됩니다.

예를 들어, 다음 코드는 "Title" 문자열이 빨간색으로 채워져 각 페이지의 헤더에 추가되도록 정의합니다:

import * as wjPdf from '@mescius/wijmo.pdf';

var doc = new wjPdf.PdfDocument({
    header: {
        declarative: {
            text: "Title",
            brush: "#ff0000"
        }
    }
});

텍스트는 최대 3개의 탭 문자(\t)를 포함할 수 있으며, 이 문자는 텍스트를 페이지 영역 내에서 왼쪽, 가운데, 오른쪽 정렬로 나누는 데 사용됩니다. 두 가지 종류의 매크로가 지원됩니다: &[Page]와 &[Pages]. 첫 번째는 현재 페이지 인덱스를 지정하며, 두 번째는 전체 페이지 수를 지정합니다.

예시:

• "&[Page]": 현재 페이지 인덱스를 왼쪽에 정렬하여 추가합니다.

• "\t&[Page] of &[Pages]": "X of Y" 형식으로 페이지 번호를 추가하며, 여기서 "X"는 현재 페이지 인덱스를, "Y"는 전체 페이지 수를 나타냅니다. 이 텍스트는 가운데 정렬됩니다.

• "\tTitle\t&[Page]: "Title" 문자열은 가운데에 정렬되고, 현재 페이지 인덱스는 오른쪽에 정렬되어 추가됩니다.

글꼴과 브러시 사용에 대한 자세한 내용은 Fonts와 Drawing Graphics 주제를 참조하시기 바랍니다.