GetStringListCount

Įvairios funkcijos

Aprašymas

Grąžina eilučių, saugomų kitos API funkcijos sukurtame eilučių sąraše, skaičių. Dažniausioji gamintoja – CheckFileCompliance, grąžinanti nenulinę StringListID, kurios įrašai išvardija tikroje dokumente rastąsias atitikimo problemas

Sintaksė

Delphi

Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;

ActiveX

Function PDFlib::GetStringListCount(StringListID As Long) As Long

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parametrai

StringListID	Eilučių sąrašo ID, toks, kokį grąžina gamintojo funkcija, tokia kaip CheckFileCompliance. Turi nurodyti esamojo PDFlib egzemplioriaus valdomąjį eilučių sąrašą

Grąžinamos reikšmės

0	Sąrašas tuščias arba StringListID nenurodo šio egzemplioriaus valdomojo galiojančio eilučių sąrašo
> 0	Šiuo metu sąraše esančių eilučių skaičius

Pastabos

Grąrintasis skaičius – viršutinė GetStringListItem ItemIndex argumento riba: galiojantys indeksai yra nuo 1 iki GetStringListCount(StringListID) imtinai. Elementai nenumeruojami nuo nulio

Eilučių sąrašams priklauso PDFlib instancija, kuri juos sukūrė, ir jie automatiškai atlaisvinami, kai instancija sunaikinama. Iškvieskite ReleaseStringList, jei norite atlaisvinti sąrašą anksčiau – pavyzdžiui, ilgai veikiančiame procese, tikrinančiame daug failų iš eilės.

Pavyzdys

// 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;

Taip pat žiūrėkite

GetStringListItem, ReleaseStringList, CheckFileCompliance