وثائق PDFiumPas

AttachmentName الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
يعيد اسم الملف Unicode المسجل للملف المضمن عند الفهرس الصفري المحدد في شجرة الأسماء EmbeddedFiles الخاصة بالمستند

الصياغة

property AttachmentName[Index: Integer]: WString; // read only

الوصف

يحمل كل مرفق ملف PDF اسما مرتبطا في قاموس مواصفات الملف، وغالبا ما يكون الاسم الأصلي كما ظهر على قرص المؤلف، مثل contract.docx أو source-data.csv. تعرض AttachmentName هذا الاسم على شكل WString حتى يمكن عرضه في واجهة مستخدم أو استخدامه كمسار مقترح للحفظ أو مطابقته بالامتداد

تفك السلسلة المعادة من تخزين PDF في UTF-16BE أو PDFDocEncoding، لذلك تعود الأسماء غير ASCII، مثل الصينية أو السيريلية أو اللاتينية ذات العلامات، بشكل صحيح. وإذا لم يترك المؤلف الأصلي سوى مدخل مفتاح من دون اسم ملف صريح /F أو /UF، فستعاد سلسلة فارغة

هذه الخاصية للقراءة فقط. لا يوفر هذا API إعادة تسمية المرفقات؛ وإذا كنت تحتاج إلى تغيير اسم ملف فاحذف الموضع بواسطة DeleteAttachment ثم أعد إنشاؤه بواسطة CreateAttachment، وبعدها أعد إسناد البايتات عبر Attachment

المعلمات

IndexInteger. موضع المرفق الصفري. يجب أن يكون ضمن [0, AttachmentCount - 1]. تمرير فهرس خارج النطاق يعيد سلسلة فارغة

ملاحظات

مثال

var
  I: Integer;
  FileName: string;
begin
  Pdf1.LoadFromFile('package.pdf');
  ListBox1.Items.BeginUpdate;
  try
    ListBox1.Items.Clear;
    for I := 0 to Pdf1.AttachmentCount - 1 do
    begin
      FileName := Pdf1.AttachmentName[I];
      if FileName = '' then
        FileName := Format('(unnamed #%d)', [I]);
      ListBox1.Items.AddObject(FileName, TObject(I));
    end;
  finally
    ListBox1.Items.EndUpdate;
  end;
end;

انظر أيضا

Attachment, AttachmentCount, AttachmentType, CreateAttachment, DeleteAttachment