GetStringListCount
기타 함수
설명
다른 API 함수에서 만든 문자열 목록에 저장된 문자열 수를 반환합니다 가장 일반적인 생성 함수는 CheckFileCompliance이며, 이 함수는 검증한 문서에서 발견된 적합성 문제를 항목으로 나열하는 0이 아닌 StringListID를 반환합니다
구문
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);매개변수
| StringListID | CheckFileCompliance 같은 생성 함수가 반환한 문자열 목록 ID입니다. 현재 PDFlib 인스턴스가 소유한 문자열 목록을 참조해야 합니다 |
|---|
반환 값
| 0 | 목록이 비어 있거나 StringListID가 이 인스턴스가 소유한 유효한 문자열 목록을 참조하지 않습니다 |
|---|---|
| > 0 | 현재 목록의 문자열 수 |
비고
반환된 개수는 ItemIndex 인수의 상한이며 GetStringListItem에 사용합니다 유효한 인덱스는 1부터 GetStringListCount(StringListID)까지 포함됩니다 항목은 0부터 번호가 매겨지지 않습니다
문자열 목록은 해당 목록을 생성한 PDFlib 인스턴스가 소유하며 인스턴스가 소멸될 때 자동으로 해제됩니다. 그보다 일찍 목록을 해제하려면 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;