ReleaseStringList

Diverse funktioner

Beskrivelse

Frigiver en strengliste, der tidligere blev returneret af en anden API-funktion (f.eks. CheckFileCompliance). Efter dette kald er StringListID-handlet ikke længere gyldigt og må ikke overføres til GetStringListCount eller GetStringListItem

Syntaks

Delphi

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

ActiveX

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

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

Parametre

StringListID	ID'et for den strengliste, der skal frigives, som tidligere returneret af en producentfunktion.

Returværdier

0	StringListID er ugyldigt eller refererer ikke til en strengliste, der ejes af denne instans.
1	Listen blev frigivet.

Bemærkninger

Strenglister ejes af den PDFlib-instans, der frembragte dem. De frigives automatisk, når instansen destrueres, så udtrykkelig frigivelse er normalt valgfri. Kald ReleaseStringList i langvarige processer, der frembringer mange lister (f.eks. en CI-arbejder, som validerer hundredvis af PDF-filer i rækkefølge), for at holde hukommelsesforbruget afgrænset.

Eksempel

// 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;

Se også

GetStringListCount, GetStringListItem, CheckFileCompliance