ReleaseStringList
Vegyes funkciók
Leírás
Felszabadít egy másik API-függvény (például a CheckFileCompliance) által korábban visszaadott sztringlistát. A hívás után a StringListID fogantyú már nem érvényes, és nem adható át a GetStringListCount vagy GetStringListItem függvénynek
Szintaxis
Delphi
Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;ActiveX
Function PDFlib::ReleaseStringList(StringListID As Long) As LongDLL
int DLReleaseStringList(int InstanceID, int StringListID);Paraméterek
| StringListID | A felszabadítandó karakterlánclista azonosítója, amelyet korábban egy előállító függvény adott vissza |
|---|
Visszatérési értékek
| 0 | A StringListID érvénytelen, vagy nem erre a példányra jellemző karakterlánclistára hivatkozik |
|---|---|
| 1 | A lista sikeresen fel lett szabadítva |
Megjegyzések
A karakterlánclisták az azokat létrehozó PDFlib példány tulajdonában vannak. A példány megsemmisítésekor automatikusan felszabadulnak, ezért külön felszabadítás általában opcionális. Sok listát előállító hosszú futású folyamatokban hívja a ReleaseStringList függvényt a memóriahasználat korlátozásához
Példa
// 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;