GetStringListCount

Diverse funktioner

Beskrivelse

Returnerer antallet af strenge, der er gemt i en strengliste oprettet af en anden API-funktion. Den mest almindelige producent er CheckFileCompliance, som returnerer et StringListID forskelligt fra nul, hvis poster viser de overensstemmelsesproblemer, der blev fundet i det validerede dokument.

Syntaks

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parametre

StringListID	Strenglistens ID som returneret af en producentfunktion som CheckFileCompliance. Skal referere til en strengliste, der ejes af den aktuelle PDFlib-instans

Returværdier

0	Listen er tom, eller StringListID henviser ikke til en gyldig strengliste, som ejes af denne instans.
> 0	Antallet af strenge, der aktuelt findes på listen

Bemærkninger

Det returnerede antal er den øvre grænse for argumentet ItemIndex i GetStringListItem: gyldige indekser er fra 1 til og med GetStringListCount(StringListID). Elementer nummereres ikke fra nul.

Strenglister ejes af den PDFlib-instans, der oprettede dem, og frigives automatisk, når instansen destrueres. Kald ReleaseStringList, hvis du vil frigive en liste tidligere – for eksempel i en langvarig proces, der validerer mange filer efter hinanden.

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