PDFium Component Docs

AttachmentName Egenskap

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.
Komponent: TPdf  ·  Enhet: PDFium
Returnerar det Unicode-filnamn som är registrerat för den inbäddade filen vid det angivna nollbaserade indexet i dokumentets EmbeddedFiles-namnträd.

Syntax

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

Beskrivning

Every PDF file attachment carries an associated file name in its file specification dictionary — typically the original file name as it appeared on the author's disk (for example contract.docx or source-data.csv). AttachmentName exposes that name as a WString så att det kan visas i ett användargränssnitt, användas som föreslagen Spara som-sökväg eller matchas via filtillägg.

Den returnerade strängen avkodas från PDF:ens UTF-16BE- eller PDFDocEncoding-lagring så att icke-ASCII-namn (kinesiska, kyrilliska, latinska tecken med accenter) klarar rundresa korrekt. När den ursprungliga författaren bara lämnade en nyckelpost utan ett uttryckligt /F- eller /UF-filnamn returneras en tom sträng.

Egenskapen är skrivskyddad. Att byta namn på en bifogad fil exponeras inte av detta API; om du behöver ändra ett filnamn, ta bort platsen med DeleteAttachment and recreate it with CreateAttachment, then re-assign the bytes through Attachment.

Parametrar

IndexInteger. Zero-based attachment position. Must be in [0, AttachmentCount - 1]. Om ett index utanför giltigt intervall skickas returneras en tom sträng.

Anmärkningar

Exempel

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;

Se även

Attachment, AttachmentCount, AttachmentType, CreateAttachment, DeleteAttachment