GetStringListCount
Različne funkcije
Opis
Vrne število nizov, shranjenih v seznamu nizov, ki ga je ustvarila druga funkcija API. Najpogostejši ustvarjalec je CheckFileCompliance, ki vrne neničelni StringListID, katerega vnosi navedejo težave skladnosti, najdene v validiranem dokumentu
Sintaksa
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;
ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As Long
DLL
int DLGetStringListCount(int InstanceID, int StringListID);
Parametri
| StringListID | ID seznama nizov, kot ga vrne ustvarjalna funkcija, npr. CheckFileCompliance. Se referencira seznam nizov v lasti trenutne instance PDFlib |
|---|
Vrnjene vrednosti
| 0 | Seznam je prazen ali se StringListID ne referencira veljaven seznam nizov v lasti te instance |
|---|---|
| > 0 | Število nizov, trenutno na seznamu |
Opombe
Vrnjena številka je zgornja meja za argument ItemIndex funkcije GetStringListItem: veljavni indeksi so 1 do GetStringListCount(StringListID), vključno. Elementi se ne štejejo od nič
Sezname nizov ima v lasti instanca PDFlib, ki jih je ustvarila, in se samodejno sprostijo, ko se instanca uniči. Če želite seznam sprostiti prej, pokličite ReleaseStringList — na primer v dolgotrajnem procesu, ki zaporedno preverja veliko datotek
Primer
// 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;