AddLinkToSubmitForm

주석 및 핫스팟 링크, 양식 필드 및 AcroForms

설명

선택한 페이지에 클릭 가능한 핫스팟 직사각형을 추가하며, 활성화 시 PDF 양식 제출 액션을 트리거합니다. 양식 제출 액션은 JavaScript 없이도 AcroForm 필드 값을 URL 또는 양식 처리 엔드포인트로 전송합니다

제출할 필드를 제한하려면 FieldNames를 사용하십시오. FieldNames를 비워 두면 뷰어가 적용 가능한 모든 필드를 제출합니다

핫스팟 테두리 색상을 변경하려면 SetAnnotBorderColor 함수를 사용하십시오

구문

Delphi

Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);

매개변수

Left	핫스팟 직사각형 왼쪽 가장자리의 가로 좌표
Top	핫스팟 직사각형 위쪽 가장자리의 세로 좌표
Width	핫스팟 직사각형의 너비
Height	핫스팟 직사각형의 높이
URL	액션 파일 사양에 저장된 제출 대상 URL
FieldNames	쉼표, 세미콜론 또는 줄 바꿈으로 구분된 완전 정규화된 AcroForm 필드 이름의 선택적 목록. 각 이름의 앞뒤 공백은 제거됩니다
Flags	액션의 `/Flags` 항목에 기록되는 PDF 양식 제출 액션 플래그. 기본 FDF 방식 제출에는 0을 전달합니다. 일반적인 표준 비트: HTML 형식은 4, XFDF는 32, 전체 PDF 문서 제출은 256
Options	링크 외관을 제어하는 비트마스크. 비트 0 (값 1): 핫스팟 직사각형 주위에 테두리를 그립니다. 비트 1–3은 클릭 하이라이트 모드를 선택합니다 (2 = 반전, 4 = 윤곽선, 8 = 누름); 하이라이트 비트가 설정되지 않으면 기본값으로 반전이 사용됩니다

반환값

0	문서가 PDF/A 모드이거나 직사각형이 유효하지 않거나 `URL`이 비어 있어 액션이 추가되지 않았습니다
1	링크 주석 및 양식 제출 액션이 추가되었습니다

설명

PDF/A 모드에서는 외부 제출 대상을 참조할 수 있으므로 이 액션을 차단합니다. 이 함수는 PDF 1.2 이상이 필요합니다