Destination - TPdf - PDFium Delphi Component

컴포넌트: TPdf · 유닛: PDFium

지정한 0 기반 index의 named destination에 대한 TDestination record를 반환합니다. named destination은 PDF 12.3.2절에서 설명하는 문서 catalog의 Dests / Names tree 아래에 정의된 간접 target입니다

Syntax

property Destination[Index: Integer]: TDestination; // read only

Description

named destination은 PDF 문서 catalog에 저장되어 구체적인 페이지-위치-확대 배율 조합으로 해석되는 상징적인 이름입니다(예: "chap5.fig3"). 아웃라인, 링크 주석, 외부 문서가 페이지 좌표를 하드코딩하는 대신 안정적인 이름으로 대상을 참조할 수 있게 해 주므로, 인바운드 링크를 깨뜨리지 않고도 문서를 재조판할 수 있습니다

PDFium Delphi Component는 예전 방식의 /Dests 딕셔너리와 최신 방식의 /Names /Dests 이름 트리를 하나의 0 기반 목록으로 펼칩니다. Destination[Index]는 destination 이름, 대상 페이지 번호(1 기반), 뷰 좌표(X, Y), 확대 배율, 그리고 각 구성 요소를 작성자가 명시적으로 설정했는지 알려 주는 Boolean 플래그를 담은 TDestination 레코드를 반환합니다

named destination 총 개수는 DestinationCount로 얻고 Destination[I]로 순회하며, 대상 이름을 이미 알고 있다면 DestinationByName을 사용하세요

Parameters

Index Integer. 펼쳐진 named destination 목록에서의 0 기반 위치입니다. [0, DestinationCount - 1] 범위 안이어야 하며, 범위를 벗어난 인덱스는 Handle = nil인 0으로 채워진 레코드를 반환합니다

Remarks

HasX, HasY, HasZoom은 명시적인 XYZ destination과 "fit page" / "fit width" destination(이 구성 요소가 없는 경우)을 구분해 줍니다. 존재 표시가 된 구성 요소만 적용하세요
ViewMode는 호출자가 PDFium 상수를 직접 해석하지 않고도 XYZ, Fit, FitH, FitV, FitR, FitB, FitBH, FitBV destination을 구분합니다
ViewParameterCount는 고정 길이 4요소 ViewParameters 배열에서 유효한 항목의 개수를 반환합니다
PDFium은 뷰 좌표를 PDF 사용자 공간(원점 왼쪽 아래, 포인트 단위)으로 보고합니다. 디바이스 공간 픽셀이 필요하면 페이지 MediaBox로 변환하세요
외부 문서가 이 PDF에 없는 이름을 참조할 수 있으며 — 그런 조회는 빈 레코드를 반환합니다. 탐색 전에 항상 Handle을 확인하세요

Example

var
  I: Integer;
  Dest: TDestination;
begin
  Pdf1.LoadFromFile('manual.pdf');
  Memo1.Lines.Add(Format('%d named destinations:', [Pdf1.DestinationCount]));
  for I := 0 to Pdf1.DestinationCount - 1 do
  begin
    Dest := Pdf1.Destination[I];
    Memo1.Lines.Add(Format('%s -> page %d (X=%.1f Y=%.1f Zoom=%.2f)',
      [Dest.Name, Dest.PageNumber, Dest.X, Dest.Y, Dest.Zoom]));
  end;
  // Navigate to the first destination
  if Pdf1.DestinationCount > 0 then
    Pdf1.PageNumber := Pdf1.Destination[0].PageNumber;
end;

Destination 속성