ReleaseStringList
Funções diversas
Descrição
Liberta uma lista de cadeias anteriormente devolvida por outra função da API (por exemplo, CheckFileCompliance). Após esta chamada, o identificador StringListID deixa de ser válido e não pode ser passado a GetStringListCount nem a GetStringListItem
Sintaxe
Delphi
Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;ActiveX
Function PDFlib::ReleaseStringList(StringListID As Long) As LongDLL
int DLReleaseStringList(int InstanceID, int StringListID);Parâmetros
| StringListID | O ID da lista de cadeias a libertar, tal como devolvido anteriormente por uma função produtora |
|---|
Valores devolvidos
| 0 | StringListID é inválido ou não referencia uma lista de cadeias pertencente a esta instância |
|---|---|
| 1 | A lista foi libertada com êxito |
Observações
As listas de cadeias pertencem à instância de PDFlib que as produziu. São libertadas automaticamente quando a instância é destruída, pelo que a libertação explícita é normalmente opcional. Invoque ReleaseStringList em processos de longa duração que produzam muitas listas (por exemplo, um trabalhador de CI que valide centenas de PDFs sequencialmente) para manter limitada a utilização de memória
Exemplo
// 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;