GetStringListCount

Разни функции

Описание

Връща броя на низовете, съхранени в списък от низове, създаден от друга API функция. Най-честият източник е CheckFileCompliance, която връща ненулев StringListID, чиито записи изброяват проблемите със съответствието, открити в проверения документ

Синтаксис

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Параметри

StringListID	ID на списъка от низове, върнат от функция-източник като CheckFileCompliance. Трябва да сочи към списък от низове, собственост на текущия екземпляр на PDFlib

Върнати стойности

0	Списъкът е празен или StringListID не сочи към валиден списък от низове, собственост на този екземпляр
> 0	Броят на низовете, които в момента са в списъка

Забележки

Върнатият брой е горната граница за аргумента ItemIndex на GetStringListItem: валидните индекси са от 1 до GetStringListCount(StringListID) включително. Елементите не се номерират от нула

Списъците от низове са собственост на екземпляра на PDFlib, който ги е създал, и се освобождават автоматично, когато екземплярът бъде унищожен. Извикайте ReleaseStringList, ако искате да освободите списък по-рано — например в дълго изпълняващ се процес, който проверява много файлове последователно

Пример

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

Вижте също

GetStringListItem, ReleaseStringList, CheckFileCompliance