AttachmentName vlastnosť

Component: TPdf · Unit: PDFium

Vráti názov súboru Unicode zaregistrovaný pre vložený súbor na zadanom indexe od nuly v strome mien EmbeddedFiles dokumentu

Syntax

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

Description

Každá príloha súboru PDF nesie pridružený názov súboru vo svojom slovníku špecifikácie súboru — zvyčajne pôvodný názov súboru, ako sa objavil na disku autora (napríklad contract.docx alebo source-data.csv). AttachmentName sprístupňuje tento názov ako WString, aby sa dal zobraziť v UI, použiť ako navrhovaná cesta pre uloženie ako, alebo zhodovať podľa prípony.

Vrátený reťazec je dekódovaný z úložiska UTF-16BE alebo PDFDocEncoding dokumentu PDF, takže názvy mimo ASCII (čínske, cyrilika, latinka s diakritikou) správne obehnutia. Ak pôvodný autor zanechal len záznam kľúča bez explicitného názvu súboru /F alebo /UF, vráti sa prázdny reťazec.

Vlastnosť je len na čítanie. Premenovanie prílohy nie je týmto API sprístupnené; ak potrebujete zmeniť názov súboru, odstráňte slot pomocou DeleteAttachment a znovu ho vytvorte pomocou CreateAttachment, potom znovu priraďte bajty cez Attachment.

Parameters

Index Integer. Pozícia prílohy so základom 0. Musí byť v [0, AttachmentCount - 1]. Odovzdanie indexu mimo rozsah vráti prázdny reťazec.

Remarks

Použite vrátený názov spolu s AttachmentType na naplnenie filtra dialógu na uloženie súboru.
Názov nie je nevyhnutne jedinečný v rámci dokumentu — dve prílohy môžu zdieľať rovnaký názov súboru. Vždy si ponechajte index pre opätovnú extrakciu namiesto vyhľadávania podľa názvu.
Pred zápisom na disk odstráňte oddeľovače cesty (\, /); niektoré nástroje na tvorbu ukladajú v názve relatívne cesty.

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;