PDFium Delphi Component Docs

Keywords ویژگی

کامپوننت: TPdf  ·  واحد: PDFium
فهرست کلیدواژه‌های ارائه‌شده توسط نویسنده از دیکشنری Info سند

Syntax

property Keywords: WString; // read only

Description

Keywords مدخل /Keywords را از دیکشنری Information سند برمی‌گرداند (بخش 14.3.3 مشخصات PDF 1.7). مقدار یک رشتهٔ متنی آزاد است که توسط ابزار تألیف نوشته شده و به‌طور قراردادی فهرستی از برچسب‌ها با جداساز ویرگول یا نقطه‌ویرگول است — مانند "invoice; 2024; payable; vendor-acme"؛ PDF جداساز را مشخص نمی‌کند، پس برنامه‌ها باید هر قالبی را که تولیدکننده نوشته بپذیرند (ویرگول، نقطه‌ویرگول، شکست خط یا جداشده با فاصله)

مقدار برگشتی UTF-16 رمزگشایی‌شده است؛ کلیدواژه‌های CJK و سایر کلیدواژه‌های غیر ASCII به‌درستی رفت و برگشت می‌کنند. رشته خالی است وقتی Active برابر False باشد، وقتی دیکشنری Info غایب باشد، یا وقتی هیچ /Keywordsای منتسب نشده است. بسیاری از ابزارهای تألیف مدرن کلیدواژه‌ها را در فرادادهٔ XMP زیر pdf:Keywords یا dc:subject (یک Bag از لفظ‌های RDF) نیز منعکس می‌کنند؛ وقتی هر دو موجودند باید مطابق باشند اما ممکن است پس از ویرایش‌ها واگرا شوند

کلیدواژه‌ها توسط نمایه‌سازهای جست‌وجوی میزکار (Windows Explorer، Spotlight، Adobe Bridge) و بیشتر سیستم‌های مدیریت سند نمایش داده می‌شوند. PDFium Delphi Component تنها رونوشت دیکشنری Info را افشا می‌کند — برای همان مقدار از طریق دسترسی‌گر عمومی فرادادهٔ PDFium به MetaText['Keywords'] دسترسی پیدا کنید

Remarks

Example

var Tags: TStringList;
Tags := TStringList.Create;
try
  Tags.Delimiter := ';';
  Tags.StrictDelimiter := True;
  Tags.DelimitedText := Pdf1.Keywords;
  ListBox1.Items.Assign(Tags);
finally
  Tags.Free;
end;

See Also

Subject, Title, Author, MetaText