GetStringListItemA

دوال متنوعة

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ GetStringListItem وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

تُرجع السلسلة في الموضع ItemIndex من قائمة السلاسل التي يحددها StringListID. تُنتج قوائم السلاسل دوال أخرى في الواجهة البرمجية — وأشهرها CheckFileCompliance التي تُرجع مدخلًا واحدًا عن كل مشكلة امتثال مرصودة

الصيغة

Delphi

Function DLGetStringListItemA(InstanceID, StringListID, ItemIndex: Integer): PAnsiChar;

DLL

const char * DLGetStringListItemA(int InstanceID, int StringListID, int ItemIndex);

المعاملات

قيمة الإرجاع

السلسلة في الفهرس المطلوب، أو سلسلة فارغة إذا كان StringListID غير صالح أو كان ItemIndex خارج [1 .. GetStringListCount]

ملاحظات

في القوائم التي تُنتجها CheckFileCompliance تكون صيغة العنصر CODE: human-readable description، حيث CODE هو أحد رموز المشكلات ذات الأرقام الخمسة الموثقة في صفحة CheckFileCompliance‏ (00002، 00003، 00005، 00006، 00007، 00011، 00012). اقتلع البادئة قبل النقطتين للتعامل مع الرمز برمجيًا

مثال

// Parse the issue code from each compliance issue line
var
  Issues, Count, I, ColonPos: Integer;
  Line, Code: WideString;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then Exit;

  Count := PDF.GetStringListCount(Issues);
  for I := 1 to Count do
  begin
    Line := PDF.GetStringListItem(Issues, I);
    ColonPos := Pos(':', Line);
    if ColonPos > 0 then
      Code := Trim(Copy(Line, 1, ColonPos - 1))
    else
      Code := Line;

    if Code = '00006' then
      WriteLn('Document is encrypted — cannot be PDF/A')
    else
      WriteLn('Issue ', Code, ': ', Line);
  end;
  PDF.ReleaseStringList(Issues);
end;

انظر أيضا

GetStringListCount, ReleaseStringList, CheckFileCompliance