GetStringListCount
Διάφορες συναρτήσεις
Περιγραφή
Επιστρέφει το πλήθος συμβολοσειρών σε λίστα που δημιούργησε άλλη συνάρτηση API. Ο πιο συνηθισμένος παραγωγός είναι το CheckFileCompliance, που επιστρέφει μη μηδενικό StringListID με εγγραφές τα ζητήματα συμμόρφωσης του επικυρωμένου εγγράφου.
Σύνταξη
Delphi
Function TPDFlib.GetStringListCount(StringListID: Integer): Integer;ActiveX
Function PDFlib::GetStringListCount(StringListID As Long) As LongDLL
int DLGetStringListCount(int InstanceID, int StringListID);Παράμετροι
| StringListID | Το ID της λίστας συμβολοσειρών όπως το επιστρέφει παραγωγός όπως το CheckFileCompliance. Πρέπει να παραπέμπει σε λίστα που κατέχει το τρέχον instance του PDFlib. |
|---|
Τιμές επιστροφής
| 0 | Η λίστα είναι κενή, ή το StringListID δεν παραπέμπει σε έγκυρη λίστα που κατέχει αυτό το instance. |
|---|---|
| > 0 | Ο αριθμός συμβολοσειρών τώρα στη λίστα |
Παρατηρήσεις
Το επιστρεφόμενο πλήθος είναι το άνω όριο για το όρισμα ItemIndex του GetStringListItem: έγκυροι δείκτες από 1 έως GetStringListCount(StringListID) συμπεριλαμβανομένου. Τα στοιχεία δεν αριθμούνται από το μηδέν.
Οι λίστες συμβολοσειρών ανήκουν στο PDFlib instance που τις παρήγαγε και απελευθερώνονται αυτόματα όταν το 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;