Keywords 속성

Keywords는 문서 Information 사전(PDF 1.7 사양 14.3.3절)의 /Keywords 항목을 반환합니다. 값은 저작 도구가 작성한 자유 형식 텍스트 문자열이며, 관례적으로 쉼표나 세미콜론으로 구분된 태그 목록입니다 — 예: "invoice; 2024; payable; vendor-acme" PDF는 구분 기호를 명시하지 않으므로 응용 프로그램은 생성자가 작성한 형식(쉼표, 세미콜론, 줄 바꿈, 공백 구분)을 모두 받아들여야 합니다

반환 값은 UTF-16으로 디코딩됩니다. CJK와 기타 비 ASCII 키워드도 올바르게 왕복합니다. Active가 False이거나 Info 사전이 없거나 /Keywords가 할당되지 않았을 때 문자열은 비어 있습니다. 최신 저작 도구 대부분은 키워드를 pdf:Keywords 또는 dc:subject(RDF 리터럴의 Bag) 아래 XMP 메타데이터로도 미러링합니다. 둘 다 있으면 일치해야 하지만 편집 후에는 달라질 수 있습니다

키워드는 데스크톱 검색 인덱서(Windows 탐색기, Spotlight, Adobe Bridge)와 대부분의 문서 관리 시스템에서 노출됩니다. PDFium Delphi Component는 Info 사전 사본만 노출합니다 — PDFium의 일반 메타데이터 접근자를 통해 동일한 값을 얻으려면 MetaText['Keywords']를 사용하세요

• 이 속성은 읽기 전용입니다. 키워드를 설정하려면 “Keywords” 태그와 함께 FPDF_SetMetaText를 직접 호출하세요
• 일부 인덱싱 파이프라인은 일치를 위해 키워드를 소문자로 변환합니다 — PDFium Delphi Component는 대소문자를 그대로 유지합니다. 문자열을 읽은 뒤 검색 계층이 필요로 하는 정규화를 적용하세요
• 이 값을 정보용 메타데이터로만 사용하세요. PDF는 키워드 길이나 내용을 제한하지 않으므로 표시할 때 신뢰할 수 없는 텍스트로 취급하세요