GetStringListCount

Razne funkcije

Opis

Vraća broj stringova u listi stringova stvorenoj drugom API funkcijom. Najčešći proizvođač je CheckFileCompliance, koji vraća StringListID različit od nule čiji unosi navode probleme usaglašenosti nađene u proverenom 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 string liste kakav vraća producerska funkcija poput CheckFileCompliance. Mora ukazivati na string listu u vlasništvu trenutne PDFlib instance

Povratne vrednosti

0	Lista je prazna, ili StringListID ne ukazuje na ispravnu string listu u vlasništvu ove instance
> 0	Broj stringova trenutno u listi

Napomene

Vraćeni broj je gornja granica za argument ItemIndex funkcije GetStringListItem: ispravni indeksi su 1 do GetStringListCount(StringListID), uključivo. Stavke se ne numerišu od nule

Liste stringova poseduje PDFlib instanca koja ih je proizvela i oslobađaju se automatski kada se instanca uništi. Pozovite ReleaseStringList ako želite da oslobodite listu ranije — na primer, u dugotrajnom procesu koji redom proverava mnoge datoteke.

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;

Vidi takođe

GetStringListItem, ReleaseStringList, CheckFileCompliance