AddPageHeaderFooter
페이지 조작, 주석
설명
AddPageHeader와 AddPageFooter의 공통 기본 요소. 범위의 모든 페이지에 위쪽 또는 아래쪽 가장자리로 반복 줄을 찍으며, 현재 선택된 폰트를 오버레이 모드로 사용하고, 스탬프 토큰을 각 대상 페이지 기준으로 확장하며, 결과를 하위 유형 Header 또는 Footer의 Pagination 아티팩트로 둘러쌈
구문
Delphi
Function TPDFlib.AddPageHeaderFooter(Const PageRange, Text: WideString;
Margin, Opacity: Double; Alignment: Integer; IsHeader: Boolean): Integer;매개변수
| PageRange | 페이지 범위 식, 빈 문자열이면 모든 페이지 |
|---|---|
| Text | 줄 텍스트. ExpandStampTokens가 이해하는 토큰이 각 대상 페이지 기준으로 확장됨 |
| Margin | 위쪽 가장자리(머리글) 또는 아래쪽 가장자리(바닥글)에서 줄까지의 거리, PDF 포인트 단위 |
| Opacity | 0과 1 사이의 텍스트 불투명도. 1이면 완전히 불투명하게 그려짐 |
| Alignment | 0이면 여백 기준 왼쪽 정렬, 1이면 여백 사이 가운데 정렬, 2이면 오른쪽 정렬하되 오른쪽 가장자리에서 여백 거리를 유지 |
| IsHeader | True이면 위쪽 여백에 머리글을 찍고, False이면 아래쪽 여백에 바닥글을 찍음 |
반환 값
줄이 찍힌 페이지 수. 문서가 선택되지 않았거나 Text가 비어 있거나 범위의 페이지를 하나도 선택할 수 없으면 0
비고
줄은 현재 폰트와 크기로 측정되므로 먼저 SelectFont를 호출해야 함. IsHeader가 True이면 줄이 위쪽 가장자리에서 Margin만큼 떨어진 곳에 놓이고, False이면 아래쪽 가장자리에서 Margin만큼 떨어진 곳에 놓이며 현재 페이지 높이와 텍스트 높이를 기준으로 계산됨. 호출이 반환되면 선택된 페이지가 복원됨
예제
PDF.SelectFont(PDF.AddStandardFont(sfHelvetica));
PDF.AddPageHeaderFooter('2-', 'Confidential - <%PageNo%>', 20, 0.6, 2, False);