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

StringListIDID seznama nizov, kot ga vrne ustvarjalna funkcija, npr. CheckFileCompliance. Se referencira seznam nizov v lasti trenutne instance PDFlib

Vrnjene vrednosti

0Seznam 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;

Glejte tudi

GetStringListItem, ReleaseStringList, CheckFileCompliance