SetEmbeddedFileAFRelationshipA

PDF/UA & 접근성

설명

뒤의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면은 Unicode 형식만 노출합니다. 동작은 SetEmbeddedFileAFRelationship와 동일하며 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용하여 해석됨

포함 파일의 파일 사양 사전에 AFRelationship 키를 설정합니다 접근 가능한 PDF 문서에 포함 파일을 넣을 때 ISO 14289-1(PDF/UA-1) §7.11에서 요구합니다

구문

Delphi

Function DLSetEmbeddedFileAFRelationshipA(InstanceID, Index: Integer; AFRelationship: PAnsiChar): Integer;

DLL

int DLSetEmbeddedFileAFRelationshipA(int InstanceID, int Index, const char * AFRelationship);

매개변수

Index포함 파일의 1부터 시작하는 인덱스입니다. 유효 범위: 1~EmbeddedFileCount
AFRelationship임베디드 파일과 문서의 관계입니다. 다음 대소문자 구분 값 중 하나여야 합니다:

Source — 임베디드 파일은 문서 생성에 사용된 원본 파일입니다
Data — 임베디드 파일은 문서에서 사용하는 데이터를 포함합니다
Alternative — 임베디드 파일은 문서 콘텐츠의 대체 표현입니다
Supplement — 임베디드 파일은 문서를 보충합니다
Unspecified — 관계가 지정되지 않았습니다(SetPDFUAMode가 활성 상태일 때의 기본값)

반환 값

성공하면 1을 반환합니다. 인덱스가 범위를 벗어났거나 AFRelationship 값이 유효한 다섯 값 중 하나가 아니거나 열린 문서가 없으면 0을 반환합니다

비고

SetPDFUAMode가 활성화되면 PDF Library for Delphi는 해당 키가 없는 모든 포함 파일의 AFRelationship를 자동으로 Unspecified로 설정합니다. 더 구체적인 관계 값으로 이 기본값을 재정의하려면 저장 전에 SetEmbeddedFileAFRelationship를 사용합니다

포함 파일을 추가한 뒤 문서를 저장하기 전에 이 함수를 호출합니다

예제

// PDF/A-3 archive that embeds an XLSX as the document's source data
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);              // PDF/A-3b — allows arbitrary embedded files
  PDF.NewDocument;
  PDF.AddStandardFont('Helvetica');
  PDF.AddPage;
  PDF.PrintText(50, 750, 'Quarterly Sales Report');

  FileID := PDF.AddEmbeddedFile(
    'sales-Q1.xlsx',
    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
  PDF.AddFileAttachment('Source spreadsheet', FileID);

  // Mark the relationship: the spreadsheet is the source of the report
  PDF.SetEmbeddedFileAFRelationship(1, 'Source');

  PDF.SaveToFile('report-PDFA3b.pdf');
end;

참고 항목

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty