ReleaseStringList

دوال متنوعة

الوصف

يحرر قائمة سلاسل أعادتها سلفًا دالة واجهة أخرى (مثل CheckFileCompliance). وبعد هذا الاستدعاء لم يعد مقبض StringListID صالحًا ويجب عدم تمريره إلى GetStringListCount أو GetStringListItem

الصيغة

Delphi

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

ActiveX

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

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

المعاملات

قيم الإرجاع

ملاحظات

قوائم السلاسل يملكها مثيل PDFlib الذي أنتجها. وتُحرر تلقائيًا عند دمار المثيل، فالتحرير الصريح اختياري عادة. واستدعِ ReleaseStringList في العمليات طويلة الأمد التي تنتج قوائم كثيرة (مثلًا عامل CI يتحقق من مئات ملفات PDF بالتسلسل) لإبقاء استخدام الذاكرة محدودًا

مثال

// Validate many files in a loop, releasing each result list as soon as it has been logged
var
  I, Issues, Count, J: Integer;
begin
  for I := 0 to Files.Count - 1 do
  begin
    Issues := PDF.CheckFileCompliance(Files[I], '', 1, 0);
    if Issues <> 0 then
    begin
      Count := PDF.GetStringListCount(Issues);
      for J := 1 to Count do
        WriteLn(Files[I], ' : ', PDF.GetStringListItem(Issues, J));
      PDF.ReleaseStringList(Issues);
    end;
  end;
end;

انظر أيضا

GetStringListCount, GetStringListItem, CheckFileCompliance