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

پارامترها

مقادیر بازگشتی

ملاحظات

شمارش برگردانده‌شده حد بالای آرگومان 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