GetStringListCount

Diverse funksjoner

Beskrivelse

Returnerer antall strenger lagret i en strengliste opprettet av en annen API-funksjon. Den vanligste produsenten er CheckFileCompliance, som returnerer en ikke-null StringListID hvis oppføringer lister samsvarsproblemene funnet i det validerte dokumentet

Syntaks

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parametere

StringListID	ID-en til strenglisten slik den returneres av en produsentfunksjon slik som CheckFileCompliance. Må referere en strengliste eid av gjeldende PDFlib-instans

Returverdier

0	Listen er tom, eller StringListID refererer ikke en gyldig strengliste eid av denne instansen
> 0	Antall strenger for tiden i listen

Merknader

Det returnerte antallet er den øvre grensen for ItemIndex-argumentet til GetStringListItem: gyldige indekser er 1 til GetStringListCount(StringListID), inklusive. Elementene er ikke nummerert fra null

Strenglister eies av PDFlib-instansen som produserte dem og frigjøres automatisk når instansen destrueres. Kall ReleaseStringList hvis du vil frigjøre en liste tidligere — for eksempel i en langvarig prosess som validerer mange filer i rekkefølge

Eksempel

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

Se også

GetStringListItem, ReleaseStringList, CheckFileCompliance