GetStringListCount

Fungsi lain-lain

Deskripsi

Mengembalikan jumlah string yang tersimpan di string list yang dibuat fungsi API lain. Producer yang paling umum adalah CheckFileCompliance, yang mengembalikan StringListID bukan nol yang entrinya menaikkan daftar issue kepatuhan yang ditemukan di dokumen yang divalidasi

Sintaks

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parameter

StringListIDID string list seperti yang dikembalikan fungsi producer seperti CheckFileCompliance. Harus mereferensikan string list yang dimiliki instance PDFlib saat ini

Nilai kembalian

0List kosong, atau StringListID tidak mereferensikan string list valid yang dimiliki instance ini
> 0Jumlah string yang saat ini ada di list

Catatan

Hitungan yang dikembalikan adalah batas atas argumen ItemIndex GetStringListItem: index valid adalah 1 sampai GetStringListCount(StringListID), inklusif. Item tidak diberi nomor dari nol

String list dimiliki instance PDFlib yang menghasilkannya dan dibebaskan otomatis saat instance dihancurkan. Panggil ReleaseStringList jika Anda ingin melepaskan sebuah list lebih awal dari itu — misalnya di proses jangka panjang yang memvalidasi banyak file secara berurutan

Contoh

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

Lihat juga

GetStringListItem, ReleaseStringList, CheckFileCompliance