SetEmbeddedFileAFRelationship

PDF/UA & 접근성

설명

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

구문

Delphi

Function TPDFlib.SetEmbeddedFileAFRelationship(Index: Integer; Const AFRelationship: WideString): Integer;

ActiveX

Function PDFlib::SetEmbeddedFileAFRelationship(Index As Long, AFRelationship As String) As Long

DLL

int DLSetEmbeddedFileAFRelationship(int InstanceID, int Index, const wchar_t * AFRelationship);

매개변수

Index	포함 파일의 1부터 시작하는 인덱스입니다. 유효 범위: 1~EmbeddedFileCount
AFRelationship	임베디드 파일과 문서의 관계입니다. 다음 대소문자 구분 값 중 하나여야 합니다: Source — 임베디드 파일은 문서 생성에 사용된 원본 파일입니다 Data — 임베디드 파일은 문서에서 사용하는 데이터를 포함합니다 Alternative — 임베디드 파일은 문서 콘텐츠의 대체 표현입니다 Supplement — 임베디드 파일은 문서를 보충합니다 Unspecified — 관계가 지정되지 않았습니다(SetPDFUAMode가 활성 상태일 때의 기본값)

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