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) כולל. הפריטים אינם ממוספרים מאפס.

רשימות מחרוזות הן בבעלות ה-instance של PDFlib שיצר אותן ומשוחררות אוטומטית כאשר ה-instance נהרס. קראו ל-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