GetStringListCount
Funciones varias
Descripción
Devuelve el número de cadenas almacenadas en una lista de cadenas creada por otra función API El productor más común es CheckFileCompliance, que devuelve un StringListID distinto de cero cuyas entradas enumeran los problemas de conformidad encontrados en el documento validado
Sintaxis
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Parámetros
| StringListID | El ID de la lista de cadenas devuelto por una función productora como CheckFileCompliance. Debe hacer referencia a una lista de cadenas propiedad de la instancia actual de PDFlib |
|---|
Valores devueltos
| 0 | La lista está vacía o StringListID no hace referencia a una lista de cadenas válida propiedad de esta instancia |
|---|---|
| > 0 | La cantidad de cadenas que hay actualmente en la lista |
Observaciones
El conteo devuelto es el límite superior para el argumento ItemIndex de GetStringListItem: los índices válidos van de 1 a GetStringListCount(StringListID), ambos incluidos Los elementos no se numeran desde cero
Las listas de cadenas pertenecen a la instancia de PDFlib que las produjo y se liberan automáticamente al destruirse la instancia. Llame a ReleaseStringList si desea liberar una lista antes de ese momento — por ejemplo, en un proceso de larga duración que valida muchos archivos en secuencia
Ejemplo
// Enumerate every compliance issue reported by CheckFileCompliance
var
Issues, Count, I: Integer;
begin
Issues := PDF.CheckFileCompliance('output.pdf', '', 1, 0);
if Issues <> 0 then
begin
Count := PDF.GetStringListCount(Issues);
for I := 1 to Count do
WriteLn(PDF.GetStringListItem(Issues, I));
PDF.ReleaseStringList(Issues);
end;
end;