PDFium Component Docs

AttachmentName Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
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

Syntaxis

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

Beschrijving

Elke PDF-bijlage heeft een bijbehorende bestandsnaam in de bestandspecificatiewoordenlijst — meestal de oorspronkelijke bestandsnaam zoals die op de schijf van de auteur stond (bijvoorbeeld contract.docx of source-data.csv). AttachmentName biedt die naam als een WString aan zodat deze in een UI kan worden weergegeven, als voorgesteld opslagpad kan worden gebruikt of op extensie kan worden gematcht

De teruggegeven tekenreeks wordt gedecodeerd uit de PDF-opslag in UTF-16BE of PDFDocEncoding zodat niet-ASCII namen (Chinees, Cyrillisch, met accenten in Latijn) correct heen en terug gaan. Wanneer de oorspronkelijke auteur alleen een sleutelvermelding achterliet zonder een expliciete /F- of /UF-bestandsnaam, wordt een lege tekenreeks teruggegeven

De eigenschap is alleen-lezen. Hernoemen van een bijlage wordt niet door deze API aangeboden; als u een bestandsnaam moet wijzigen, verwijdert u het slot met DeleteAttachment en maakt u het opnieuw aan met CreateAttachment, waarna u de bytes opnieuw toewijst via Attachment

Parameters

IndexInteger. Bijlagepositie op basis van 0. Moet liggen in [0, AttachmentCount - 1]. Een index buiten bereik doorgeven geeft een lege tekenreeks terug

Opmerkingen

Voorbeeld

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;

Zie ook

Attachment, AttachmentCount, AttachmentType, CreateAttachment, DeleteAttachment