GetStringListCount

دوال متنوعة

الوصف

تُرجع عدد السلاسل المخزنة في قائمة سلاسل أنشأتها دالة واجهة أخرى. وأشهر منتج هي 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معرف قائمة السلاسل كما تُرجعه دالة منتجة مثل 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