ApplyPageHeaderFooterSet

페이지 레이아웃, 페이지 매김, HTML 텍스트

설명

첫 페이지 및 실제 페이지 홀짝 선택을 사용하여 이름이 지정된 머리글 및 바닥글 세트를 페이지 범위에 적용합니다

구문

Delphi

Function TPDFlib.ApplyPageHeaderFooterSet(Const SetName,
  PageRange: WideString): Integer;

ActiveX

Function PDFlib::ApplyPageHeaderFooterSet(SetName As String,
  PageRange As String) As Long

DLL

int DLApplyPageHeaderFooterSet(int InstanceID, const wchar_t* SetName,
  const wchar_t* PageRange);
int DLApplyPageHeaderFooterSetA(int InstanceID, const char* SetName,
  const char* PageRange);

매개변수

SetName앞서 SetPageHeaderFooterVariant로 등록한 대/소문자를 구분하지 않는 이름
PageRange페이지 범위 표현식 또는 모든 페이지를 나타내는 빈 문자열

반환 값

그린 비어 있지 않은 머리글 및 바닥글 요소 수를 반환하며 집합이나 범위에 적용 가능한 콘텐츠가 없거나 현재 API 범위에서 페이지를 변경할 수 없으면 0을 반환합니다

비고

각 머리글 및 바닥글 역할에서 범위가 반환한 첫 페이지는 정의된 경우 first를 사용하고, 이후 페이지는 실제 페이지 번호에 따라 odd 또는 even을 사용하며, 특정 변형이 없으면 default로 대체함

명시적으로 정의된 빈 variant는 아무것도 그리지 않고 대체를 방지하므로 빈 첫 페이지를 지원합니다

모든 템플릿은 측정 전에 대상 페이지에 맞게 확장되며 HTML 변형은 확장된 마크업을 자동 높이 계산에 사용합니다

생성된 콘텐츠는 페이지 매김 아티팩트로 표시되며 호출자가 선택한 페이지, 글꼴, Painter 상태 및 커닝 설정이 복원됨

예제

PDF.SetPageHeaderFooterVariant('manual', 'default',
  '<b>Manual</b> — <%PageNo%>/<%TotalPages%>', 36, 0, 0.8, 2, 0, 1);
if PDF.ApplyPageHeaderFooterSet('manual', '3-20')= 0 then
  HandleLayoutError;