GetStringListCount

Miscellaneous functions

Description

يرجع عدد السلاسل المخزنة في قائمة سلاسل تم إنشاؤها بواسطة وظيفة API أخرى؛ والمنتج الأكثر شيوعاً هو CheckFileCompliance، والذي يرجع معرف StringListID غير صفري تسرد مدخلاته مشاكل التوافق التي تم العثور عليها في المستند الذي تم التحقق منه

Syntax

Delphi

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

ActiveX

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

DLL

int DLGetStringListCount(int InstanceID, int StringListID);

Parameters

StringListID	معرف قائمة السلاسل كما تم إرجاعه بواسطة دالة منتجة مثل CheckFileCompliance Must reference a string list owned by the current PDFlib instance.

Return values

0	القائمة فارغة، أو أن StringListID لا يشير إلى قائمة سلاسل صالحة مملوكة لهذا المثيل
> 0	عدد السلاسل الموجودة حاليًا في القائمة

Remarks

العدد المرجع هو الحد الأقصى لمعامل ItemIndex لـ GetStringListItem؛ والمؤشرات الصالحة هي من 1 إلى GetStringListCount(StringListID) شاملة؛ ولا يتم ترقيم العناصر من الصفر

قوائم السلاسل مملوكة لمثيل PDFlib الذي أنتجها ويتم تحريرها تلقائيًا عند تدمير المثيل؛ استدعِ ReleaseStringList إذا كنت تريد تحرير قائمة قبل ذلك — على سبيل المثال، في عملية طويلة التشغيل تتحقق من صحة العديد من الملفات بالتسلسل

Example

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