GetStringListCount

Funcții diverse

Descriere

Returnează numărul de șiruri stocate într-o listă de șiruri creată de altă funcție API. Cel mai comun producător este CheckFileCompliance, care returnează un StringListID nenul ale cărui intrări listează problemele de conformitate găsite în documentul validat

Sintaxă

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-ul listei de șiruri, așa cum este returnat de o funcție producătoare precum CheckFileCompliance. Trebuie să refere o listă de șiruri deținută de instanța PDFlib curentă

Valori returnate

0Lista este vidă, sau StringListID nu referește o listă de șiruri validă deținută de această instanță
> 0Numărul de șiruri aflat în prezent în listă

Observații

Numărul returnat este limita superioară pentru argumentul ItemIndex al GetStringListItem: indexurile valide sunt de la 1 la GetStringListCount(StringListID), inclusiv. Elementele nu sunt numerotate de la zero

Listele de șiruri sunt deținute de instanța PDFlib care le-a produs și sunt eliberate automat când instanța este distrusă. Apelați ReleaseStringList dacă vreți să eliberați o listă mai devreme — de exemplu, într-un proces de durată care validează multe fișiere în secvență

Exemplu

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

Consultați și

GetStringListItem, ReleaseStringList, CheckFileCompliance