ReleaseStringList

Funzioni varie

Descrizione

Rilascia un elenco di stringhe restituito in precedenza da un'altra funzione API, ad esempio CheckFileCompliance. Dopo questa chiamata, l'handle StringListID non è più valido e non deve essere passato a GetStringListCount né a GetStringListItem

Sintassi

Delphi

Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;

ActiveX

Function PDFlib::ReleaseStringList(StringListID As Long) As Long

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

Parametri

StringListID	ID dell'elenco di stringhe da rilasciare, come restituito in precedenza da una funzione produttrice

Valori restituiti

0	StringListID non è valido oppure non fa riferimento a un elenco di stringhe di proprietà di questa istanza
1	L'elenco è stato rilasciato correttamente

Note

Gli elenchi appartengono all'istanza PDFlib che li crea e vengono liberati alla distruzione. Chiamare ReleaseStringList nei processi lunghi che producono molti elenchi per limitare la memoria

Esempio

// Validate many files in a loop, releasing each result list as soon as it has been logged
var
  I, Issues, Count, J: Integer;
begin
  for I := 0 to Files.Count - 1 do
  begin
    Issues := PDF.CheckFileCompliance(Files[I], '', 1, 0);
    if Issues <> 0 then
    begin
      Count := PDF.GetStringListCount(Issues);
      for J := 1 to Count do
        WriteLn(Files[I], ' : ', PDF.GetStringListItem(Issues, J));
      PDF.ReleaseStringList(Issues);
    end;
  end;
end;

Vedere anche

GetStringListCount, GetStringListItem, CheckFileCompliance