Keywords プロパティ

Keywords は、ドキュメント Information 辞書の /Keywords entry を返します(PDF 1.7 仕様 14.3.3 節)。値は作成ツールが書いた自由形式のテキストで、慣習的にはコンマかセミコロン区切りのタグのリストです。例: "invoice; 2024; payable; vendor-acme"。PDF は区切り文字を規定していないので、アプリケーション側では作成ツールが書いたどんな形式(コンマ、セミコロン、改行、空白区切り)も受け入れなければなりません

戻り値はデコード済みの UTF-16 で、CJK を含む非 ASCII キーワードも正しく往復します。Active が False のとき、Info 辞書がないとき、/Keywords が設定されていないときは空文字列です。近年の作成ツールの多くはキーワードを XMP メタデータの pdf:Keywords や dc:subject(RDF リテラルの Bag)にも複製します。両方ある場合は一致しているべきですが、編集を重ねるとずれることがあります

キーワードはデスクトップの検索インデクサー(Windows エクスプローラー、Spotlight、Adobe Bridge)や、ほとんどのドキュメント管理システムが拾います。PDFium Delphi Component が公開するのは Info 辞書側のコピーだけです。同じ値は PDFium の汎用メタデータアクセサー経由の MetaText['Keywords'] でも得られます

• このプロパティは読み取り専用です。キーワードを設定するには「Keywords」タグで FPDF_SetMetaText を直接呼びます
• インデックスパイプラインの中には照合のためにキーワードを小文字化するものがあります。PDFium Delphi Component は大文字小文字をそのまま保存します。読み取ったあと、検索層が要求する正規化を施してください
• この値は情報提供用のメタデータとしてだけ使ってください。PDF はキーワードの長さや内容を制限しないため、表示時は信頼できないテキストとして扱います