AddLinkToSubmitForm

Σχολιασμοί και σύνδεσμοι hotspot, Πεδία φόρμας και AcroForms

Περιγραφή

Προσθέτει ένα κλικαριστό ορθογώνιο hotspot στην επιλεγμένη σελίδα, το οποίο ενεργοποιεί μια ενέργεια υποβολής φόρμας PDF όταν ενεργοποιηθεί. Μια ενέργεια υποβολής φόρμας αποστέλλει τις τιμές πεδίων AcroForm σε ένα URL ή σε ένα τελικό σημείο επεξεργασίας φόρμας χωρίς να απαιτείται JavaScript

Χρησιμοποιήστε το FieldNames για να περιορίσετε τα υποβαλλόμενα πεδία. Αφήστε το FieldNames κενό για να επιτρέψετε στον viewer να υποβάλει όλα τα εφαρμόσιμα πεδία

Χρησιμοποιήστε τη συνάρτηση SetAnnotBorderColor για να αλλάξετε το χρώμα του περιγράμματος του hotspot

Σύνταξη

Delphi

Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);

Παράμετροι

Left	Η οριζόντια συντεταγμένη της αριστερής πλευράς του ορθογωνίου hotspot
Top	Η κατακόρυφη συντεταγμένη της άνω πλευράς του ορθογωνίου hotspot
Width	Το πλάτος του ορθογωνίου hotspot
Height	Το ύψος του ορθογωνίου hotspot
URL	Το URL υποβολής-στόχου που αποθηκεύεται στην προδιαγραφή αρχείου της ενέργειας
FieldNames	Προαιρετική λίστα πλήρως κατονομασμένων ονομάτων πεδίων AcroForm, διαχωρισμένων με κόμματα, ερωτηματικά ή αλλαγές γραμμής. Τα αρχικά και τελικά κενά γύρω από κάθε όνομα αποκόπτονται
Flags	Σημαίες ενέργειας υποβολής φόρμας PDF που εγγράφονται στην καταχώριση `/Flags` της ενέργειας. Δώστε 0 για την προεπιλεγμένη υποβολή τύπου FDF. Κοινά τυπικά bits περιλαμβάνουν 4 για μορφή HTML, 32 για XFDF και 256 για υποβολή ολόκληρου του εγγράφου PDF
Options	Bitmask που ελέγχει την εμφάνιση του συνδέσμου. Bit 0 (τιμή 1): σχεδίαση πλαισίου γύρω από το ορθογώνιο hotspot. Bits 1-3 επιλέγουν τη λειτουργία επισήμανσης κλικ (2 = Invert, 4 = Outline, 8 = Push)· όταν δεν έχει οριστεί bit επισήμανσης, χρησιμοποιείται το Invert ως προεπιλογή

Τιμές επιστροφής

0	Η ενέργεια δεν προστέθηκε επειδή το έγγραφο βρίσκεται σε λειτουργία PDF/A, το ορθογώνιο είναι μη έγκυρο ή το `URL` είναι κενό
1	Η σχολίαση συνδέσμου και η ενέργεια υποβολής φόρμας προστέθηκαν

Παρατηρήσεις

Η λειτουργία PDF/A μπλοκάρει αυτή την ενέργεια επειδή μπορεί να αναφέρεται σε εξωτερικό στόχο υποβολής. Η συνάρτηση απαιτεί PDF 1.2 ή νεότερη έκδοση