Lucrul cu legături și referințe

Lucrul cu legături și referințe

Lucrul cu linkuri și referințe

Codurile de câmp pentru legături și referințe încrucișate în Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, și altele – sunt fiecare implementate ca o Field subclasă în Aspose.Words FOSS pentru .NET. Toate aceste clase se află în Aspose.Words.Fields spațiul de nume alături de fiecare alt tip de câmp; această pagină grupează pe cele care se ocupă în mod specific de legături, referințe încrucișate, valori solicitate și citări, și prezintă ce expune fiecare dintre ele.


Hyperlinks

FieldHyperlink reprezintă câmpul HYPERLINK: Address și SubAddress conțin URL-ul țintă sau locația din document, ScreenTip setează indiciul la trecerea mouse-ului, OpenInNewWindow și IsImageMap sunt steaguri de afișare, iar Target numește un cadru de browser. Pentru cazuri simple, DocumentBuilder.InsertHyperlink() inserează un câmp hyperlink direct, fără a construi manual obiectul Field.


Referințe încrucișate la semne de carte

FieldRef (câmpul REF), FieldPageRef (PAGEREF) și FieldNoteRef (NOTEREF) se rezolvă fiecare la conținutul unui semn de carte numit prin proprietatea lor BookmarkName, cu InsertHyperlink și InsertRelativePosition care controlează dacă referința este clicabilă și dacă raportează o poziție relativă („deasupra” / „sub”). FieldRef adaugă opțiuni de numerotare a paragrafelor (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) și IncludeNoteOrComment. FieldStyleRef (STYLEREF) în schimb se rezolvă la cel mai apropiat paragraf formatat cu un anumit StyleName, cu SearchFromBottom pentru a căuta înapoi de la poziția câmpului. Semnele de carte vizate de aceste câmpuri sunt create cu DocumentBuilder.StartBookmark() și EndBookmark(), și pot fi accesate cu MoveToBookmark(). FieldSet (SET) definește o valoare de text semn de carte – BookmarkName și BookmarkText – pe care un câmp REF din altă parte îl poate rezolva.


Câmpuri cu valori solicitate

FieldAsk (ASK) și FieldFillIn (FILLIN) solicită o valoare de la oricine actualizează câmpul: PromptText este afișat utilizatorului, DefaultResponse furnizează o soluție de rezervă, și PromptOnceOnMailMerge limitează solicitările repetate în timpul unei fuziuni de corespondență. FieldAsk în plus, stochează răspunsul său la BookmarkName pentru ca alte câmpuri să le facă referire. Vezi ghidul de câmpuri for IFieldUserPromptRespondent, apelul invers care furnizează răspunsuri acestor câmpuri programatic, în loc să solicite interactiv.


Conținut extern și legat

FieldDde (DDE) și FieldDdeAuto (DDEAUTO) leagă la conținut dintr-o altă aplicație prin ProgId, SourceFullName și SourceItem, cu InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode și InsertAsBitmap selectând reprezentarea inserată, și AutoUpdate / IsLinked controlând comportamentul de reîmprospătare. FieldLink (LINK) este echivalentul OLE-link, adăugând FormatUpdateType. FieldImport (IMPORT) și FieldIncludePicture (INCLUDEPICTURE) încarcă un grafic extern prin SourceFullName și GraphicFilter. FieldInclude (INCLUDE) și FieldIncludeText (INCLUDETEXT) încarcă conținut de document extern, cu BookmarkName pentru a delimita intervalul inclus și LockFields pentru a împiedica reîmprospătarea; FieldIncludeText susține, de asemenea, surse XML prin Encoding, MimeType, NamespaceMappings, XPath și XslTransformation.


AutoText și referințe la glosar

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) și FieldGlossary (GLOSSARY) fac toate referire la o intrare numită de tip building-block prin EntryName; FieldAutoTextList adaugă ListStyle și ScreenTip pentru prezentarea sa în stil listă.


Câmpuri de citare și bibliografie

FieldCitation (CITATION) și FieldBibliography (BIBLIOGRAPHY) redă conținutul preluat din datele bibliografice ale documentului. FieldCitation.SourceTag (și alternativa AnotherSourceTag) identifică sursa pe care o citează, cu Prefix, Suffix, PageNumber, VolumeNumber, și Suppress* indicatori (SuppressAuthor, SuppressTitle, SuppressYear) controlând modul în care este formatată citația. FieldBibliography.SourceTag, FilterLanguageId, și FormatLanguageId controlează care surse apar în bibliografia redată și în ce limbă. Înregistrările sursei de bază redau aceste câmpuri – Source, Contributor, Person – sunt acoperite în ghidul de bibliografie.


Câmpuri de citat și text de formă

FieldQuote (QUOTE) și FieldShape (SHAPE) expun ambele o proprietate Text care conține text literal al câmpului – FieldQuote îl inserează direct la poziția câmpului, în timp ce FieldShape îl asociază cu codul de câmp al formei de desen care poartă text.


Sfaturi și cele mai bune practici

  • Preferă DocumentBuilder.InsertHyperlink() pentru inserarea simplă a hyperlink-urilor; apelează la construirea directă a unui FieldHyperlink doar când ai nevoie de proprietăți precum ScreenTip sau IsImageMap pe care scurtătura de construcție nu le expune.
  • FieldRef, FieldPageRef, FieldNoteRef și FieldSet se coordonează toate prin BookmarkName – asigură-te că semnul de carte țintă există (prin DocumentBuilder.StartBookmark() / EndBookmark()) înainte ca câmpul care îl referă să fie actualizat.
  • Set FieldOptions.UserPromptRespondent (vezi ghidul de câmpuri) înainte de a actualiza un document care conține FieldAsk or FieldFillIn câmpuri într-un pipeline neasistat.
  • FieldDde și FieldDdeAuto modelează un mecanism de legare OLE moștenit de Windows – tratează AutoUpdate și IsLinked ca informaționale atunci când procesezi documente în afara Windows, deoarece aplicația externă din care ar fi actualizat în mod normal nu este disponibilă.
  • Câmpurile de citare și bibliografie se redau corect doar după ce structura de bază a documentului. Source înregistrările există – vezi ghidul de bibliografie pentru a le construi.

Probleme comune

ProblemăCauzăRemediere
REF / PAGEREF / NOTEREF câmpul afișează un rezultat de eroareBookmarkName pe care îl vizează nu există în documentCreează semnul de carte cu DocumentBuilder.StartBookmark() / EndBookmark() înainte de a actualiza câmpul
Câmpul ASK / FILLIN blochează o actualizare nesupravegheatăNiciun IFieldUserPromptRespondent nu este atribuitAtribuie FieldOptions.UserPromptRespondent, sau setează DefaultResponse pe câmp
Câmpul CITATION sau BIBLIOGRAPHY afișează golSourceTag nu se potrivește cu niciun Source din datele bibliografice ale documentuluiAdaugă potrivirea Source – vezi ghid de bibliografie
DDE / DDEAUTO / LINK câmpul nu se actualizeazăAceste fac referire la o sursă OLE externă care nu este disponibilă în mediul curentAșteptat în afara contextului original Windows/OLE – tratați Result stocat ca valoarea ultimă cunoscută

FAQ

Care este diferența dintre FieldRef și FieldStyleRef?

FieldRef rezolvă la conținutul de la un semn de carte numit (BookmarkName); FieldStyleRef în schimb rezolvă la cel mai apropiat paragraf formatat cu un anumit StyleName, independent de semnele de carte.

Cum pot insera o legătură simplă fără să construiesc manual un Field?

Apelă DocumentBuilder.InsertHyperlink().

Aceste clase de câmpuri de legătură și referință se află într-un spațiu de nume separat față de alte câmpuri?

Nu – FieldHyperlink, FieldRef, FieldCitation, iar restul claselor de pe această pagină sunt obișnuite Field subclase în Aspose.Words.Fields spațiu de nume, același spațiu de nume acoperit în ghidul câmpurilor.

Cum se raportează câmpurile de citare la modelul de date al bibliografiei?

FieldCitation and FieldBibliography randează conținutul prin căutare SourceTag împotriva Source înregistrările descrise în ghidul de bibliografie – clasele de câmp gestionează randarea și Source / Contributor clasele dețin datele subiacente.


Rezumat API Reference

ClasăDescriere:
FieldHyperlinkHYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF câmpuri; rezolvă conținutul la un BookmarkName
FieldStyleRefSTYLEREF câmp; se rezolvă la cel mai apropiat paragraf într-un stil dat
FieldSetSET câmp; definește o valoare de text marcată pentru REF de rezolvat
FieldAsk / FieldFillInASK / FILLIN câmpuri; solicită o valoare în timpul actualizării
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK câmpuri; conținut extern legat prin OLE legacy
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE câmpuri; conținut grafic extern
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT câmpuri; document extern sau XML conținut
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY câmpuri; intrări de blocuri de construcție de referință
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY câmpuri; redă datele sursă ale bibliografiei
FieldQuote / FieldShapeQUOTE / SHAPE câmpuri; text literal al câmpului
DocumentBuilder.InsertHyperlinkScurtătură de inserare a hyperlink-ului la nivel înalt
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkCrearea de marcaje și navigarea către țintele de referință

Vezi și:

 Română