GetStringListCount
Vegyes funkciók
Leírás
Visszaadja egy másik API-függvény által létrehozott karakterlánclistában tárolt karakterláncok számát. A leggyakoribb előállító a CheckFileCompliance, amely nem nulla StringListID értéket ad vissza, és ennek bejegyzései a hitelesített dokumentumban talált megfelelőségi problémákat sorolják fel
Szintaxis
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Paraméterek
| StringListID | Egy előállító függvény, például a CheckFileCompliance által visszaadott sztringlista azonosítója. Az aktuális PDFlib-példány tulajdonában lévő sztringlistára kell hivatkoznia |
|---|
Visszatérési értékek
| 0 | A lista üres, vagy a StringListID nem hivatkozik az e példány tulajdonában lévő érvényes karakterlánclistára |
|---|---|
| > 0 | A listában jelenleg található karakterláncok száma |
Megjegyzések
A visszaadott szám a ItemIndex argumentumának felső határa: az érvényes indexek a GetStringListItem 1 és GetStringListCount(StringListID) közötti értékek, a végpontokat is beleértve. Az elemek számozása nem nullától kezdődik
A sztringlisták az őket létrehozó PDFlib-példány tulajdonában vannak, és a példány megsemmisítésekor automatikusan felszabadulnak. Ha korábban szeretne listát felszabadítani, hívja a ReleaseStringList függvényt — például olyan hosszan futó folyamatban, amely egymás után sok fájlt ellenőriz
Példa
// 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;