GetStringListCount
Sonstige Funktionen
Beschreibung
Gibt die Anzahl der Zeichenfolgen zurück, die in einer von einer anderen API-Funktion erstellten Zeichenfolgenliste gespeichert sind. Der häufigste Erzeuger ist CheckFileCompliance, das eine von null verschiedene StringListID zurückgibt, deren Einträge die im validierten Dokument gefundenen Konformitätsprobleme aufführen
Syntax
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Parameter
| StringListID | Die ID der Zeichenfolgenliste, wie sie von einer Erzeugerfunktion wie CheckFileCompliance zurückgegeben wird. Sie muss auf eine Zeichenfolgenliste verweisen, die der aktuellen PDFlib-Instanz gehört. |
|---|
Rückgabewerte
| 0 | Die Liste ist leer oder StringListID verweist nicht auf eine gültige Zeichenfolgenliste, die dieser Instanz gehört |
|---|---|
| > 0 | Die Anzahl der aktuell in der Liste enthaltenen Zeichenfolgen |
Anmerkungen
Die zurückgegebene Anzahl ist die Obergrenze für das Argument ItemIndex von GetStringListItem: Gültige Indizes reichen einschließlich von 1 bis GetStringListCount(StringListID). Elemente werden nicht ab null nummeriert
Zeichenfolgenlisten gehören der PDFlib-Instanz, die sie erzeugt hat, und werden automatisch freigegeben, wenn die Instanz zerstört wird. Rufen Sie ReleaseStringList auf, wenn Sie eine Liste früher freigeben möchten — beispielsweise in einem lang laufenden Prozess, der viele Dateien nacheinander validiert
Beispiel
// 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;