עבודה עם קישורים והפניות

עבודה עם קישורים והפניות

סקירה

קודי השדה של קישור והפניה צולבת ב-Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, ועוד – מיושמים כל אחד כתת-מחלקה ייעודית Field תת-מחלקה ב- Aspose.Words FOSS עבור .NET. כל המחלקות האלה ממוקמות ב- Aspose.Words.Fields מרחב השמות לצד כל סוג שדה אחר; דף זה מקבץ את אלה שמיועדים במיוחד לקישורים, הפניות צולבות, ערכים שמוצגים, וציטוטים, ומסביר מה כל אחד חושף.


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 מגביל הצגת שאלות חוזרות במהלך מיזוג דואר. FieldAsk בנוסף שומר את תשובתו ב BookmarkName כדי ששדות אחרים יוכלו להתייחס אליו. ראו את מדריך השדות for IFieldUserPromptRespondent, הקריאה חוזרת (callback) שמספקת תשובות לשדות אלה באופן תכנותי במקום לבקש באופן אינטראקטיבי.


תוכן חיצוני ומקושר

FieldDde (DDE) ו-FieldDdeAuto (DDEAUTO) מקשרים לתוכן ביישום אחר דרך ProgId, SourceFullName ו-SourceItem, כאשר InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode ו-InsertAsBitmap בוחרים את הייצוג המוכנס, ו-AutoUpdate / IsLinked שולטים בהתנהגות הרענון. FieldLink (LINK) הוא המקביל לקישור OLE, מוסיף 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 מממשים מנגנון קישור OLE מיושן של Windows – התייחס ל-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().

האם מחלקות השדה של קישור והפניה נמצאות במרחב שם נפרד משדות אחרים?

לא – FieldHyperlink, FieldRef, FieldCitation, ושאר המחלקות בעמוד זה הן רגילות Field מחלקות משנה ב- Aspose.Words.Fields מרחב שמות, אותו מרחב שמות מכוסה ב- מדריך השדות.

איך שדות הציטוט קשורים למודל הנתונים של הביבליוגרפיה?

FieldCitation and FieldBibliography הצגת תוכן על ידי חיפוש SourceTag נגד Source רשומות המתוארות ב מדריך ביבליוגרפיה – מחלקות השדה מטפלות ברינדור, וה Source / Contributor המחלקות מחזיקות בנתונים הבסיסיים.


API Reference סיכום

מחלקהתיאור
FieldHyperlinkHYPERLINK שדה; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefשדות REF / PAGEREF / NOTEREF; פותר תוכן בBookmarkName
FieldStyleRefשדה STYLEREF; מתקבל לפסקה הקרובה ביותר בסגנון נתון
FieldSetשדה SET; מגדיר ערך טקסט מסומן עבור REF לפתרון
FieldAsk / FieldFillInASK / FILLIN שדות; מבקש ערך במהלך העדכון
FieldDde / FieldDdeAuto / FieldLinkשדות DDE / DDEAUTO / LINK; תוכן חיצוני מקושר ב-OLE מדור קודם
FieldImport / FieldIncludePictureשדות IMPORT / INCLUDEPICTURE; תוכן גרפי חיצוני
FieldInclude / FieldIncludeTextשדות INCLUDE / INCLUDETEXT; מסמך חיצוני או תוכן XML
FieldAutoText / FieldAutoTextList / FieldGlossaryשדות AUTOTEXT / AUTOTEXTLIST / GLOSSARY; ערכי בנייה של הפניות
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY שדות; הצגת נתוני מקור של ביבליוגרפיה
FieldQuote / FieldShapeQUOTE / SHAPE שדות; טקסט מילולי של השדה
DocumentBuilder.InsertHyperlinkקיצור דרך להוספת קישור ברמה גבוהה
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkיצירת סימניות וניווט למטרות ייחוס

ראה גם

 עברית