GetStringListCount
Hàm khác
Mô tả
Trả về số chuỗi lưu trong một danh sách chuỗi do một hàm API khác tạo. Producer phổ biến nhất là CheckFileCompliance, trả về một StringListID khác 0 mà các mục liệt kê các vấn đề tuân thủ tìm thấy trong tài liệu đã kiểm tra
Cú pháp
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Tham số
| StringListID | ID của danh sách chuỗi do một hàm sản xuất như CheckFileCompliance trả về. Phải tham chiếu một danh sách chuỗi thuộc instance PDFlib hiện tại |
|---|
Giá trị trả về
| 0 | Danh sách rỗng, hoặc StringListID không tham chiếu một danh sách chuỗi hợp lệ thuộc instance này |
|---|---|
| > 0 | Số chuỗi hiện có trong danh sách |
Ghi chú
Số đếm trả về là giới hạn trên cho tham số ItemIndex của GetStringListItem: các chỉ số hợp lệ là 1 đến GetStringListCount(StringListID), tính cả hai đầu. Mục không đánh số từ 0
Danh sách chuỗi thuộc về instance PDFlib đã tạo ra chúng và được giải phóng tự động khi instance bị hủy. Hãy gọi ReleaseStringList nếu muốn giải phóng danh sách sớm hơn – ví dụ trong một tiến trình chạy lâu kiểm tra nhiều tệp liên tiếp.
Ví dụ
// 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;