ReleaseStringList

Diverse funksjoner

Beskrivelse

Frigir en strengliste tidligere returnert av en annen API-funksjon (for eksempel CheckFileCompliance). Etter dette kallet er StringListID-håndtaket ikke lenger gyldig og må ikke sendes 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);

Parametere

StringListID	ID-en til strenglisten som skal frigjøres, slik den tidligere ble returnert av en produsentfunksjon

Returverdier

0	StringListID er ugyldig eller refererer ikke til en strengliste eid av denne instansen
1	Listen ble frigitt

Merknader

Strenglister eies av PDFlib-instansen som produserte dem. De frigjøres automatisk når instansen ødelegges, så eksplisitt frigjøring er normalt valgfritt. Kall ReleaseStringList i langvarige prosesser som produserer mange lister (for eksempel en CI-arbeider som validerer hundrevis av PDF-er i sekvens) for å holde minnebruken begrenset

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