GetStringListCount
Funzioni varie
Descrizione
Restituisce il numero di stringhe memorizzate in un elenco di stringhe creato da un'altra funzione API. Il produttore più comune è CheckFileCompliance, che restituisce uno StringListID diverso da zero le cui voci elencano i problemi di conformità individuati nel documento convalidato
Sintassi
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Parametri
| StringListID | ID dell'elenco di stringhe restituito da una funzione produttrice quale CheckFileCompliance. Deve fare riferimento a un elenco di stringhe appartenente all'istanza PDFlib corrente |
|---|
Valori restituiti
| 0 | L'elenco è vuoto oppure StringListID non identifica un elenco valido di proprietà dell'istanza |
|---|---|
| > 0 | Il numero di stringhe attualmente presenti nell'elenco |
Note
Il conteggio restituito è il limite superiore dell'argomento ItemIndex di GetStringListItem: gli indici validi vanno da 1 a GetStringListCount(StringListID) incluso. Gli elementi non sono numerati a partire da zero
Gli elenchi appartengono all'istanza PDFlib e vengono liberati alla distruzione. Chiamare ReleaseStringList per liberarli prima, ad esempio in processi lunghi
Esempio
// 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;