PDFium Delphi Component Docs

Keywords الخاصية

Component: TPdf  ·  Unit: PDFium
قائمة كلمات مفتاحية يزوّدها المؤلف من قاموس Info الخاص بالمستند

Syntax

property Keywords: WString; // read only

Description

تُرجع الخاصية Keywords مدخل /Keywords من قاموس المعلومات للمستند (القسم 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 نسخة قاموس المعلومات فقط — فاستخدم MetaText['Keywords'] للوصول إلى القيمة نفسها عبر مُوصِل البيانات الوصفية العام في PDFium.

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