ReleaseStringList
Funciones varias
Descripción
Libera una lista devuelta por otra API, como CheckFileCompliance. Después StringListID deja de ser válido para GetStringListCount o GetStringListItem
Sintaxis
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 | El identificador de la lista de cadenas que se liberará, según lo devolvió anteriormente una función productora |
|---|
Valores devueltos
| 0 | StringListID no es válido o no hace referencia a una lista de cadenas propiedad de esta instancia |
|---|---|
| 1 | La lista se ha liberado correctamente |
Observaciones
Las listas de cadenas pertenecen a la instancia de PDFlib que las produjo. Se liberan automáticamente al destruirse la instancia, por lo que normalmente su liberación explícita es opcional. Llame a ReleaseStringList en procesos de larga duración que produzcan muchas listas (por ejemplo, un trabajador de CI que valide cientos de archivos PDF de forma secuencial) para mantener acotado el uso de memoria
Ejemplo
// 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;