הערות שוליים והערות סיום
הערות שוליים והערות סיום
Aspose.Words FOSS for .NET מייצג הערות שוליים והערות סיום עם מחלקת צומת Footnote יחידה שמובדלת על ידי המאפיין FootnoteType, לצד אפשרויות מספור נפרדות ומחלקות מפריד במרחב השמות Aspose.Words.Notes.
קריאת תוכן של הערת שוליים והערת סיום
Footnote הוא צומת סיפור מורכב — כמו Body או תא בטבלה, הוא מכיל Paragraphs ו-Tables — שמחזיק את הטקסט של הערת שוליים אחת או הערת סיום אחת. המאפיין FootnoteType שלו (ערך enum FootnoteType, Footnote או Endnote) מזהה איזו סוג זה. ReferenceMark מחזיר את תו סימן ההפניה המוגדר, ActualReferenceMark מחזיר את הסימן שמוצג בפועל (בהתחשב במספור אוטומטי), ו-IsAuto מדווח האם הסימן ממוספר אוטומטית. ParentParagraph ממקם את הפיסקה בגוף המסמך הראשי שבו מתרחשת הפנייה להערת שוליים או הערת סיום. GetText() מחלץ את תוכן הטקסט הפשוט של ההערה, במקביל לשיטה הזמינה בצמתים ברמת הסיפור האחרים.
הגדרת מספור ומיקום
התנהגות המספור והמיקום נשלטת בנפרד עבור הערות שוליים והערות סיום דרך FootnoteOptions ו-EndnoteOptions, שניים המיישמים את הממשק המשותף IFootnoteOptions. FootnoteOptions.Position (ערך FootnotePosition — BottomOfPage או BeneathText) ו-EndnoteOptions.Position (ערך EndnotePosition — EndOfSection או EndOfDocument) קובעים היכן כל סוג ממוקם. שניהם חושפים את NumberStyle, StartNumber, ו-RestartRule (ערך FootnoteNumberingRule — Continuous, RestartSection, RestartPage או Default) כדי לשלוט ברצף המספור. FootnoteOptions בנוסף חושף את Columns, לפריסת הערות שוליים בתחתית העמוד בעמודות מרובות.
מפרידי הערות שוליים והערות סיום
FootnoteSeparator הוא צומת סיפור המחזיק את התוכן שמוסיף Word בין גוף המסמך הראשי להערות השוליים/הסיום — קו אופקי קצר כברירת מחדל, אך הוא יכול להכיל כל תוכן פסקה. המאפיין SeparatorType שלו (ערך מסוג FootnoteSeparatorType) מבדיל בין שש תפקידי מפריד שה-Word מגדיר: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, והמקבילים של ההערות הסופיות. FootnoteSeparatorCollection מספק גישה מכוונת לכל צמתים של מפרידים במסמך דרך GetByFootnoteSeparatorType(FootnoteSeparatorType).
טיפים ושיטות עבודה מומלצות
- בדוק את
Footnote.FootnoteTypeלפני שאתה מניח שמחווןFootnoteהוא הערת שוליים — אותה המחלקה מייצגת גם הערות שוליים וגם הערות סיום. - השתמש ב-
ActualReferenceMarkבמקוםReferenceMarkכאשר אתה צריך את הסימן כפי שהוא יוצג בפועל, מכיוון שסימנים ממוספרים אוטומטית שונים מהתו המוגדר. - הגדר את
FootnoteOptionsו-EndnoteOptionsלפני הוספת תוכן של הערת שוליים/הערת סיום כדי שכללי המספור יחולו באופן עקבי מההערה הראשונה. - תוכן ה-
FootnoteSeparatorנדיר לשינוי — רוב המסמכים מסתמכים על המפריד ברירת המחדל של Word — אך הוא נגיש במלואו אם מסמך דורש הודעת המשך מותאמת.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
| הערת שוליים והערת סיום הוטעו בלוגיקה של העיבוד | שניהם משתמשים במחלקה Footnote זהה | מבוסס על Footnote.FootnoteType |
| טקסט סימון ההפניה אינו תואם לפלט המוצג | השתמש ב-ReferenceMark במקום ActualReferenceMark | קרא ActualReferenceMark עבור סימן התצוגה |
| המספור מתחדש באופן בלתי צפוי לכל עמוד/סעיף | RestartRule מוגדר לRestartPage או RestartSection | הגדר RestartRule לContinuous עבור מספור ברמת המסמך |
| עמודות ההערות השוליים מתעלמות בתחתית העמוד | FootnoteOptions.Columns לא מוגדר | הגדר Columns במפורש על FootnoteOptions |
FAQ
איך אוכל להבחין בין הערת שוליים להערת סוף בקוד?
בדוק את המאפיין FootnoteType על האובייקט Footnote — הוא מחזיר FootnoteType.Footnote או FootnoteType.Endnote.
האם הערות שוליים והערות סוף יכולות להיות בעלות כללי מספור שונים?
כן — FootnoteOptions ו-EndnoteOptions מוגדרים באופן בלתי תלוי, לכל אחד מהם Position, NumberStyle, StartNumber ו-RestartRule משלו.
למה משמש FootnoteSeparator?
זה מייצג את התוכן ש-Word מוסיף כדי להפריד חזותית בין גוף המסמך הראשי להערות השוליים או הערות הסוף שלו, וכן את ההודעה שמופיעה כאשר הערת שוליים נמשכת לעמוד הבא.
האם Footnote תומך בטבלאות בתוך ההערה?
כן — Footnote חושף מאפיין Tables לצד Paragraphs, מכיוון שהוא צומת סיפור מורכב כמו גוף המסמך הראשי.
API Reference סיכום
| מחלקה / שיטה | תיאור |
|---|---|
Footnote | צומת מכולה לתוכן של הערת שוליים או הערת סיום אחת |
FootnoteType | Enum: Footnote, Endnote |
FootnoteOptions | הגדרות מספור ומיקום של הערות שוליים למסמך/סעיף |
EndnoteOptions | הגדרות מספור ומיקום של הערות סיום למסמך/סעיף |
FootnotePosition / EndnotePosition | Enumים למיקום (BottomOfPage/BeneathText, EndOfSection/EndOfDocument) |
FootnoteNumberingRule | Enum השולט מתי המספור מתחיל מחדש |
FootnoteSeparator | צומת סיפור לתוכן המפריד של הערת שוליים/הערת סיום |
FootnoteSeparatorCollection | גישה טיפוסית לכל צמתים מסוג FootnoteSeparator |
FootnoteSeparatorType | Enum המזהה איזו מהששת תפקידי המפריד הצומת מייצג |
