GetStringListCount
Sekalaiset funktiot
Kuvaus
Palauttaa toisen API-funktion luomaan merkkijonoluetteloon tallennettujen merkkijonojen määrän. Yleisin tuottaja on CheckFileCompliance, joka palauttaa ei-nollan StringListID:n, jonka tietueet luettelevat validoidusta asiakirjasta löydetyt vaatimustenmukaisuusongelmat
Syntaksi
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Parametrit
| StringListID | Merkkijonoluettelon tunnus sellaisena kuin tuottajafunktio kuten CheckFileCompliance sen palauttaa. Sen on viitattava nykyisen PDFlib-instanssin omistamaan merkkijonoluetteloon |
|---|
Paluuarvot
| 0 | Luettelo on tyhjä tai StringListID ei viittaa tähän instanssiin kuuluvaan kelvolliseen merkkijonoluetteloon |
|---|---|
| > 0 | Tällä hetkellä luettelossa olevien merkkijonojen määrä |
Huomautukset
Palautettu määrä on GetStringListItemn ItemIndex-argumentin yläraja: kelvolliset indeksit ovat 1–GetStringListCount(StringListID), ääripäät mukaan lukien. Kohteita ei numeroida nollasta
Merkkijonoluettelot kuuluvat niitä tuottaneelle PDFlib-instanssille, ja ne vapautetaan automaattisesti, kun instanssi tuhotaan. Kutsu funktiota ReleaseStringList, jos haluat vapauttaa luettelon aiemmin — esimerkiksi pitkäkestoisessa prosessissa, joka validoi monia tiedostoja
Esimerkki
// 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;