THPDFPage.AddGoToRStructureDestinationLink Method
GoToR 액션이 외부 PDF의 구조 요소를 해당 요소의 바이트 문자열 /ID로 가리키게 만든 링크 주석을 추가하며, 원격 파일 쪽에는 필수 /D 폴백 페이지 목적지를 그대로 유지합니다
선언
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');유닛
HPDFDoc
매개변수
| 이름 | 용도 |
|---|---|
Rectangle | 페이지 단위로 표현한, 링크가 활성화되는 핫스팟 사각형 |
FileName | 외부 PDF의 경로로, 비어 있지 않아야 하며 역슬래시는 슬래시로 정규화됩니다 |
RemoteStructElemID | /ID는 비어 있지 않은 바이트 문자열입니다. FileName 안에 있는 대상 StructElem의 ID이며, 그 요소에 부여된 /ID와 일치해야 합니다. 이 값은 IDStr 오버로드가 있는 AddStructureElement로 부여합니다 |
FallbackTargetPageIndex | /D 폴백 목적지가 쓰는 원격 파일의 0 기반 페이지 인덱스로, >= 0이어야 합니다 |
YPos | /XYZ fit에 쓸 선택적 세로 위치, null로 두려면 음수를 전달합니다 |
NewWindow | true이면 /NewWindow true를 출력해 뷰어가 대상을 새 창으로 엽니다 |
Description | 주석 /Contents에 저장되는 대체 설명이며, PDFUACompliance 사용 시 필수입니다 |
반환 값
이 멤버는 값을 반환하지 않습니다
동작
- PDF 2.0(ISO 32000-2)이 필요하고
StrictVersionLock동작을 따릅니다 - 원격 구조 대상은 포인터로 다른 문서의 StructElem을 참조할 수 없기 때문에, ISO 32000-2 §12.3.2.3은 첫 번째
/SD요소가 대상 요소의 바이트 문자열/ID가 되도록 요구합니다. 출력되는 literal string 형태는 같은IDStr에 대해AddStructureElement가 만드는/ID형태와 일치합니다 /F와 필수/D폴백 목적지,/SD바이트 문자열 배열을 갖춘 GoToR 액션을 출력합니다- 빈
FileName, 빈RemoteStructElemID, 음수FallbackTargetPageIndex는 주석이나 버전 상승이 출력되기 전에 예외를 발생시킵니다