Εργασία με Συνδέσμους και Αναφορές

Εργασία με Συνδέσμους και Αναφορές

Επισκόπηση

Κωδικοί πεδίων συνδέσμου και παραπομπής του Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, και άλλα – υλοποιούνται καθένα ως ένα αφιερωμένο Field υποκατηγορία σε Aspose.Words FOSS για .NET. Όλες αυτές οι κλάσεις ζουν στο Aspose.Words.Fields namespace μαζί με κάθε άλλο τύπο πεδίου· αυτή η σελίδα ομαδοποιεί εκείνες που αφορούν ειδικά συνδέσμους, παραπομπές, προτεινόμενες τιμές και αναφορές, και καλύπτει τι εκθέτει το καθένα.


Hyperlinks

FieldHyperlink αντιπροσωπεύει το πεδίο HYPERLINK: Address και SubAddress κρατούν τη διεύθυνση URL προορισμού ή τη θέση εντός του εγγράφου, ScreenTip ορίζει το tooltip κατά το πέρασμα του ποντικιού, OpenInNewWindow και IsImageMap είναι σημαίες εμφάνισης, και Target ονομάζει ένα πλαίσιο του προγράμματος περιήγησης. Για απλές περιπτώσεις, το DocumentBuilder.InsertHyperlink() εισάγει ένα πεδίο υπερσυνδέσμου απευθείας χωρίς να κατασκευάσει το αντικείμενο Field με το χέρι.


Διασταυρούμενες Αναφορές σε Σελιδοδείκτες

FieldRef (το πεδίο REF), FieldPageRef (PAGEREF), και FieldNoteRef (NOTEREF) καθένα αναλύει το περιεχόμενο σε έναν ονομασμένο σελιδοδείκτη μέσω της ιδιότητας BookmarkName, με τα InsertHyperlink και InsertRelativePosition να ελέγχουν αν η αναφορά είναι κλικ-δυνατή και αν αναφέρει σχετική θέση («πάνω» / «κάτω»). Το FieldRef προσθέτει επιλογές αρίθμησης παραγράφων (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) και IncludeNoteOrComment. Το FieldStyleRef (STYLEREF) αντί αυτού αναλύει την πλησιέστερη παράγραφο μορφοποιημένη με δεδομένο StyleName, με SearchFromBottom για αναζήτηση προς τα πίσω από τη θέση του πεδίου. Οι σελιδοδείκτες που στοχεύουν αυτά τα πεδία δημιουργούνται με DocumentBuilder.StartBookmark() και EndBookmark(), και μπορούν να πλοηγηθούν με MoveToBookmark(). Το FieldSet (SET) ορίζει μια τιμή κειμένου σελιδοδείκτη — BookmarkName και BookmarkText — που ένα πεδίο REF αλλού μπορεί να αναλύσει.


Πεδία Προτρεπόμενων Τιμών

FieldAsk (ASK) και FieldFillIn (FILLIN) ζητούν μια τιμή από όποιον ενημερώνει το πεδίο: PromptText εμφανίζεται στον χρήστη, DefaultResponse παρέχει εναλλακτική, και PromptOnceOnMailMerge περιορίζει την επαναλαμβανόμενη προτροπή κατά τη διάρκεια ενός mail merge. FieldAsk επιπλέον αποθηκεύει την απάντησή του στο BookmarkName για άλλα πεδία να το αναφέρουν. Δείτε το οδηγός πεδίων for IFieldUserPromptRespondent, η callback που παρέχει απαντήσεις σε αυτά τα πεδία προγραμματιστικά αντί για προτροπή διαδραστικά.


Εξωτερικό και Συνδεδεμένο Περιεχόμενο

FieldDde (DDE) και FieldDdeAuto (DDEAUTO) συνδέονται σε περιεχόμενο σε άλλη εφαρμογή μέσω ProgId, SourceFullName και SourceItem, με τα InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode και InsertAsBitmap να επιλέγουν την εισαχθείσα αναπαράσταση, και τα AutoUpdate / IsLinked να ελέγχουν τη συμπεριφορά ανανέωσης. Το FieldLink (LINK) είναι το ισοδύναμο OLE-link, προσθέτοντας το FormatUpdateType. Τα FieldImport (IMPORT) και FieldIncludePicture (INCLUDEPICTURE) φέρνουν ένα εξωτερικό γραφικό μέσω SourceFullName και GraphicFilter. Τα FieldInclude (INCLUDE) και FieldIncludeText (INCLUDETEXT) φέρνουν εξωτερικό περιεχόμενο εγγράφου, με το BookmarkName για να περιορίσει το περιεχόμενο που συμπεριλαμβάνεται και το LockFields για να αποτρέψει την ανανέωσή του· το FieldIncludeText υποστηρίζει επιπλέον πηγές XML μέσω Encoding, MimeType, NamespaceMappings, XPath και XslTransformation.


AutoText και Αναφορές Γλωσσαρίου

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) και FieldGlossary (GLOSSARY) αναφέρονται όλα σε μια ονομασμένη καταχώρηση δομικού μπλοκ μέσω EntryName; το FieldAutoTextList προσθέτει τα ListStyle και ScreenTip για την παρουσίαση του σε στυλ λίστας.


Πεδία Παραπομπής και Βιβλιογραφίας

FieldCitation (CITATION) και FieldBibliography (BIBLIOGRAPHY) αποδίδει περιεχόμενο που προέρχεται από τα δεδομένα βιβλιογραφίας του εγγράφου. FieldCitation.SourceTag (και το εναλλακτικό AnotherSourceTag) προσδιορίζει ποια πηγή παραθέτει, με Prefix, Suffix, PageNumber, VolumeNumber, και το Suppress* σημαίες (SuppressAuthor, SuppressTitle, SuppressYear) που ελέγχουν πώς μορφοποιείται η παραπομπή. FieldBibliography.SourceTag, FilterLanguageId, και FormatLanguageId ελέγχουν ποιες πηγές εμφανίζονται στη δημιουργημένη βιβλιογραφία και σε ποια γλώσσα. Η υποκείμενη πηγή καταγράφει αυτά τα πεδία που αποδίδονται – Source, Contributor, Person – καλύπτονται στο οδηγός βιβλιογραφίας.


Πεδία Κειμένου Παράθεσης και Σχήματος

FieldQuote (QUOTE) και FieldShape (SHAPE) εκθέτουν και οι δύο μια ιδιότητα Text που περιέχει κυριολεκτικό κείμενο πεδίου – FieldQuote το εισάγει άμεσα στη θέση του πεδίου, ενώ FieldShape το συσχετίζει με τον κώδικα πεδίου που φέρει κείμενο σε σχήμα σχεδίασης.


Συμβουλές και Καλές Πρακτικές

  • Προτιμήστε το DocumentBuilder.InsertHyperlink() για απλή εισαγωγή υπερσυνδέσμου· κατασκευάστε ένα FieldHyperlink απευθείας μόνο όταν χρειάζεστε ιδιότητες όπως το ScreenTip ή το IsImageMap που δεν εκτίθενται από τη συντόμευση του δημιουργού.
  • FieldRef, FieldPageRef, FieldNoteRef και FieldSet συντονίζονται όλα μέσω BookmarkName – βεβαιωθείτε ότι το στοχευόμενο σελιδοδείκτη υπάρχει (μέσω DocumentBuilder.StartBookmark() / EndBookmark()) πριν ενημερωθεί το πεδίο που το αναφέρει.
  • Ορίστε FieldOptions.UserPromptRespondent (δείτε το οδηγός πεδίων) πριν από την ενημέρωση ενός εγγράφου που περιέχει FieldAsk or FieldFillIn πεδία σε μια αδιάβλεπτη γραμμή εργασίας.
  • FieldDde και FieldDdeAuto μοντελοποιούν έναν παλιό μηχανισμό σύνδεσης Windows OLE – θεωρήστε τα AutoUpdate και IsLinked ως πληροφοριακά κατά την επεξεργασία εγγράφων εκτός των Windows, επειδή η εξωτερική εφαρμογή από την οποία θα ανανεώνονταν κανονικά δεν είναι διαθέσιμη.
  • Τα πεδία παράθεσης και βιβλιογραφίας αποδίδονται σωστά μόνο όταν η υποκείμενη Source υπάρχουν εγγραφές – δείτε το οδηγός βιβλιογραφίας για τη δημιουργία τους.

Συνηθισμένα Προβλήματα

ΠρόβλημαΑιτίαΔιόρθωση
Το πεδίο REF / PAGEREF / NOTEREF εμφανίζει αποτέλεσμα σφάλματοςΤο BookmarkName που στοχεύει δεν υπάρχει στο έγγραφοΔημιουργήστε το σελιδοδείκτη με DocumentBuilder.StartBookmark() / EndBookmark() πριν την ενημέρωση του πεδίου
Το πεδίο ASK / FILLIN εμποδίζει μια αυτόματη ενημέρωσηΔεν έχει ανατεθεί IFieldUserPromptRespondentΑναθέστε FieldOptions.UserPromptRespondent, ή ορίστε DefaultResponse στο πεδίο
Το πεδίο CITATION ή BIBLIOGRAPHY εμφανίζεται κενόΤο SourceTag δεν ταιριάζει με κανένα Source στα δεδομένα βιβλιογραφίας του εγγράφουΠροσθέστε το ταίριασμα Source – δείτε το οδηγός βιβλιογραφίας
το πεδίο DDE / DDEAUTO / LINK δεν ανανεώνεταιΑυτά αναφέρονται σε μια εξωτερική πηγή OLE που δεν είναι διαθέσιμη στο τρέχον περιβάλλονΑναμένεται εκτός του αρχικού πλαισίου Windows/OLE – αντιμετωπίστε το αποθηκευμένο Result ως την τελευταία γνωστή τιμή

FAQ

Ποια είναι η διαφορά μεταξύ FieldRef και FieldStyleRef;

FieldRef αντιστοιχεί στο περιεχόμενο ενός ονομασμένου σελιδοδείκτη (BookmarkName); FieldStyleRef αντίθετα αντιστοιχεί στην πλησιέστερη παράγραφο που έχει μορφοποιηθεί με ένα δεδομένο StyleName, ανεξάρτητα από σελιδοδείκτες.

Πώς μπορώ να εισάγω έναν απλό υπερσύνδεσμο χωρίς να δημιουργήσω ένα Field με το χέρι;

Καλέστε DocumentBuilder.InsertHyperlink().

Αυτές οι κλάσεις πεδίων συνδέσμου και αναφοράς είναι σε ξεχωριστό namespace από άλλα πεδία;

Όχι – FieldHyperlink, FieldRef, FieldCitation, και οι υπόλοιπες κλάσεις σε αυτή τη σελίδα είναι συνηθισμένες Field υποκλάσεις στο Aspose.Words.Fields namespace, το ίδιο namespace που καλύπτεται στο οδηγός πεδίων.

Πώς σχετίζονται τα πεδία παραπομπής με το μοντέλο δεδομένων της βιβλιογραφίας;

FieldCitation and FieldBibliography αποδίδουν περιεχόμενο αναζητώντας SourceTag εναντίον του Source εγγραφές που περιγράφονται στο οδηγός βιβλιογραφίας – οι κλάσεις πεδίου διαχειρίζονται την απόδοση, και οι Source / Contributor οι κλάσεις περιέχουν τα υποκείμενα δεδομένα.


API Reference Σύνοψη

ΚλάσηΠεριγραφή
FieldHyperlinkHYPERLINK πεδίο; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF πεδία; επιλύστε το περιεχόμενο σε ένα BookmarkName
FieldStyleRefSTYLEREF πεδίο; επιλύεται στην πλησιέστερη παράγραφο σε ένα δεδομένο στυλ
FieldSetSET πεδίο; ορίζει μια τιμή κειμένου σε σελιδοδείκτη για το REF ώστε να επιλυθεί
FieldAsk / FieldFillInASK / FILLIN πεδία; ζητούν τιμή κατά την ενημέρωση
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK πεδία; παλαιό εξωτερικό περιεχόμενο συνδεδεμένο μέσω OLE
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE πεδία; εξωτερικό γραφικό περιεχόμενο
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT πεδία; εξωτερικό έγγραφο ή XML περιεχόμενο
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY πεδία; αναφορά σε καταχωρήσεις δομικών μονάδων
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY πεδία· απόδοση δεδομένων πηγής βιβλιογραφίας
FieldQuote / FieldShapeQUOTE / SHAPE πεδία· κυριολεκτικό κείμενο πεδίου
DocumentBuilder.InsertHyperlinkΣυντόμευση εισαγωγής υπερσύνδεσμου υψηλού επιπέδου
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkΔημιουργία σελιδοδείκτη και πλοήγηση για στόχους αναφοράς

Δείτε επίσης

 Ελληνικά