GetStringListCount

Çeşitli işlevler

Açıklama

Başka bir API işleviyle oluşturulan dize listesinde saklanan dizelerin sayısını döndürür. En yaygın üretici, doğrulanan belgede bulunan uyumluluk sorunlarını listeleyen girdilere sahip, sıfır olmayan bir StringListID döndüren CheckFileCompliance işlevidir

Sözdizimi

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parametreler

StringListIDCheckFileCompliance gibi üretici işlevin döndürdüğü dize listesi kimliği. Geçerli PDFlib örneğinin sahip olduğu bir dize listesine başvurmalıdır

Dönüş değerleri

0Liste boş veya StringListID bu örneğin sahip olduğu geçerli bir dize listesine başvurmuyor
> 0Şu anda listedeki dize sayısı

Açıklamalar

Döndürülen sayı, ItemIndex bağımsız değişkeninin GetStringListItem için üst sınırıdır: geçerli dizinler 1 ile GetStringListCount(StringListID) arasındadır ve uçlar dâhildir. Öğeler sıfırdan numaralandırılmaz

Dize listeleri bunları üreten PDFlib örneğinin mülkiyetindedir ve örnek yok edildiğinde otomatik olarak serbest bırakılır. Bir listeyi daha önce serbest bırakmak istiyorsanız ReleaseStringList çağrısını yapın — örneğin birçok dosyayı sırayla doğrulayan uzun süre çalışan bir işlemde

Örnek

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

Ayrıca bkz

GetStringListItem, ReleaseStringList, CheckFileCompliance