GetStringListItem
Çeşitli işlevler
Açıklama
StringListID ile tanımlanan dize listesinde ItemIndex konumundaki dizeyi döndürür. Dize listeleri başka API işlevleri tarafından üretilir — en yaygın olarak algılanan her uygunluk sorunu için bir girdi döndüren CheckFileCompliance tarafından
Sözdizimi
Delphi
Function TPDFlib.GetStringListItem(StringListID, ItemIndex: Integer): WideString;ActiveX
Function PDFlib::GetStringListItem(StringListID As Long, ItemIndex As Long) As StringDLL
const wchar_t * DLGetStringListItem(int InstanceID, int StringListID, int ItemIndex);Parametreler
| StringListID | CheckFileCompliance gibi bir üretici işlevinin döndürdüğü dize listesinin ID değeri |
|---|---|
| ItemIndex | Alınacak öğenin bir tabanlı dizini. İlk öğe 1, son öğe GetStringListCount(StringListID) değeridir. Aralık dışındaki dizinler boş dize döndürür |
Dönüş değeri
İstenen dizindeki dize; StringListID geçersizse veya ItemIndex [1 .. GetStringListCount] aralığının dışındaysa boş dize
Açıklamalar
CheckFileCompliance tarafından üretilen listelerde öğe biçimi CODE: human-readable description şeklindedir; burada CODE, CheckFileCompliance sayfasında belgelenen beş basamaklı sorun kodlarından biridir (00002, 00003, 00005, 00006, 00007, 00011, 00012). Kod üzerinde programlı işlem yapmak için iki noktadan önceki öneki ayırın
Örnek
// 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;