THPDFPage.AddStructureDestinationLink Method
GoTo 액션에 필수 페이지 좌표 /D 폴백 목적지와, 간접 참조로 대상 StructElem을 가리키는 PDF 2.0 /SD 배열을 함께 실은 링크 주석을 추가합니다. 덕분에 PDF 2.0 뷰어는 구조 콘텐츠로 이동하고 구형 뷰어는 지정된 페이지로 폴백합니다
선언
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');유닛
HPDFDoc
매개변수
| 이름 | 용도 |
|---|---|
Rectangle | 페이지 단위로 표현한, 링크가 활성화되는 핫스팟 사각형 |
StructElem | 대상으로 지정할 nil이 아닌 간접 StructElem 딕셔너리로, 보통 AddStructureElement나 FindStructureElementForMCID에서 가져옵니다 |
FallbackPageIndex | PDF 2.0 이전 뷰어를 위해 /D 명시적 목적지가 사용하는 필수 페이지 인덱스 |
YPos | /XYZ fit에 쓸 선택적 세로 위치, null로 두려면 음수를 전달합니다 |
Description | 주석 /Contents에 저장되는 대체 설명이며, PDFUACompliance에서는 필수입니다 |
반환 값
이 멤버는 값을 반환하지 않습니다
동작
/SD는 PDF 2.0 액션 항목이므로 PDF 2.0(ISO 32000-2)이 필요하고StrictVersionLock동작을 따릅니다AddGoToLink와 같은[page /XYZ null y null]형태의/D를 담은 GoTo 액션에, 간접 StructElem 참조를 담은 단일 요소/SD배열을 더해 출력합니다nilStructElem이나 범위를 벗어난FallbackPageIndex는 주석이나 버전 상승이 출력되기 전에 예외를 발생시킵니다PDFUACompliance에서는 빈Description이 PDF/UA-1 §7.18.5에 따라 예외를 발생시킵니다