AddLinkToNamedAction
주석 및 핫스폿 링크, 페이지 속성
설명
선택한 페이지에 활성화 시 PDF 이름 지정 작업을 실행하는 클릭 가능한 핫스폿 사각형을 추가합니다. 이름 지정 작업은 ISO 32000-1 §12.6.4.11, Table 194에 정의된 뷰어 제어 탐색 명령입니다. 지원되는 네 가지 표준 이름은 NextPage, PrevPage, FirstPage 및 LastPage입니다. AddLinkToPage와 달리 명시적 대상 페이지 번호가 필요하지 않으며 — 뷰어가 런타임에 명령을 해석합니다
대표적인 용도: 페이지 머리글 또는 바닥글의 탐색 버튼(Next / Previous / Home / End)으로, 대상은 Viewer가 현재 표시 중인 페이지를 기준으로 함
핫스폿 테두리의 색상을 변경하려면 SetAnnotBorderColor 함수를 사용합니다
구문
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;
DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);
매개변수
| Left | 핫스폿 사각형 왼쪽 가장자리의 가로 좌표 |
|---|---|
| Top | 핫스폿 사각형 위쪽 가장자리의 세로 좌표 |
| Width | 핫스폿 사각형의 너비 |
| Height | 핫스폿 사각형의 높이 |
| NamedActionType | 트리거할 이름 있는 작업을 선택합니다: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. 범위를 벗어난 값은 NextPage로 대체되므로 작성기는 항상 명세에 맞는 /N 이름을 출력합니다 |
| Options | 링크 모양을 제어하는 비트 마스크입니다. 비트 0(값 1): 핫스폿 사각형 주위에 테두리를 그립니다. 비트 1–3은 클릭 강조 모드(2 = Invert, 4 = Outline, 8 = Push)를 선택하며, 강조 비트가 설정되지 않으면 Invert가 기본값으로 사용됩니다. AddLinkToWeb / AddLinkToPage와 같은 규칙을 사용합니다 |
비고
외부 리소스를 참조하지 않으므로 주석은 PDF/A와 호환됩니다. PDF 1.1 이상이 필요합니다