AttachmentName - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Geeft de Unicode-bestandsnaam terug die is geregistreerd voor het ingesloten bestand op de opgegeven index op basis van 0 in de EmbeddedFiles-naamboom van het document

Syntax

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

Description

Elke PDF-bestandsbijlage heeft een bijbehorende bestandsnaam in zijn file specification-dictionary — doorgaans de oorspronkelijke bestandsnaam zoals die op de schijf van de auteur stond (bijvoorbeeld contract.docx of source-data.csv). AttachmentName stelt die naam bloot als een WString, zodat u hem in een gebruikersinterface kunt tonen, als voorgesteld opslagpad kunt gebruiken of op extensie kunt matchen

De teruggegeven tekenreeks is gedecodeerd uit de UTF-16BE- of PDFDocEncoding-opslag van de PDF, zodat niet-ASCII-namen (Chinees, Cyrillisch, Latijns met diakritische tekens) correct blijven. Waar de oorspronkelijke auteur alleen een key-vermelding achterliet zonder expliciete /F- of /UF-bestandsnaam, wordt een lege tekenreeks teruggegeven

De eigenschap is alleen-lezen. Het hernoemen van een bijlage wordt door deze API niet blootgesteld; als u een bestandsnaam moet wijzigen, verwijder dan het slot met DeleteAttachment en maak het opnieuw aan met CreateAttachment, en wijs daarna de bytes opnieuw toe via Attachment

Parameters

Index Integer. Op nul gebaseerde bijlagepositie. Moet binnen [0, AttachmentCount - 1] liggen. Een index buiten het bereik geeft een lege tekenreeks terug

Remarks

Gebruik de teruggegeven naam samen met AttachmentType om het filter van een opslagdialoog te vullen
De naam is niet noodzakelijk uniek binnen een document — twee bijlagen kunnen dezelfde bestandsnaam hebben. Bewaar altijd de index voor her-extractie in plaats van op naam te zoeken
Verwijder padscheiders (\, /) uit de naam voordat u naar schijf schrijft; sommige authoringtools bewaren relatieve paden in de naam

Example

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;

AttachmentName Eigenschap