GetStringListCount
Funciones varias
Descripción
Devuelve el número de cadenas almacenadas en una lista de cadenas creada por otra función de la API. El productor más habitual 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 | ID de lista de cadenas devuelto por una función como CheckFileCompliance. Debe pertenecer a la instancia PDFlib actual |
|---|
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 | El número de cadenas que hay actualmente en la lista |
Observaciones
El número devuelto es el límite superior del argumento ItemIndex de GetStringListItem: los índices válidos van desde 1 hasta 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 — por ejemplo, en un proceso de larga duración que valide muchos archivos secuencialmente
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;