עבודה עם Headers & Footers

Aspose.Words מאפשר למשתמשים לעבוד עם Headers ו Footers במסמך. כותרת היא טקסט ממוקם בחלק העליון של דף, וצוואר הוא טקסט בתחתית העמוד. בדרך כלל, אזורים אלה משמשים כדי להוסיף מידע שיש לחזור על כל או כמה דפים של המסמך, כגון מספרי דף, תאריך יצירה, מידע של החברה וכן הלאה.

צור כותרות או Footers באמצעות DocumentBuilder

אם אתה רוצה להוסיף מנהל מסמך או מנהל קדמית, הדרך הקלה ביותר היא להשתמש DocumentBuilder הכיתה לעשות את זה.

הדוגמה הבאה של הקוד מראה כיצד להוסיף ראש ורגל לדפים:

כאשר אתה מוסיף מנהל או רגל למסמך, אתה יכול להגדיר כמה תכונות מתקדמות. Aspose.Words מספק למשתמשים את HeaderFooter ו HeaderFooterCollection שיעורים, כמו HeaderFooterType הערכה שנותנת לך שליטה רבה יותר על תהליך ההתאמה הראש והרגל.

ניתן לציין שלושה סוגים שונים של ראש ושלושה סוגים שונים עבור מסמך אחד:

1.1 1. Header ו/או Footer for the First page 2. Header ו/או Footer for אפילו דפים 3. Header ו/או Footer for Strange דפים

הדוגמה הבאה של הקוד מראה כיצד להוסיף כותרת עבור דפי מסמך מוזרים:

ציין האם להציג ראשים שונים או Footers עבור הדף הראשון

כפי שנאמר לעיל, אתה יכול גם להגדיר ראש אחר או רגל עבור הדף הראשון. כדי לעשות זאת, עליך להגדיר את different_first_page_header_footer דגל true ולאחר מכן הצצה אל HeaderFirst או FooterFirst ערך.

לדוגמה הקוד הבא מראה כיצד להגדיר את ראש העמוד הראשון בלבד:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.page_setup.different_first_page_header_footer = True
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_FIRST)
builder.write("Header for the first page.")
builder.move_to_header_footer(aw.HeaderFooterType.FOOTER_FIRST)
builder.write("Footer for the first page.")
builder.move_to_section(0)
builder.writeln("Page 1")
builder.insert_break(aw.BreakType.PAGE_BREAK)
builder.writeln("Page 2")
doc.save(ARTIFACTS_DIR + "WorkingWithHeadersAndFooters.different_first_page.docx")

ציין האם להציג ראשים שונים או Footers for Odd or Even Pages

לאחר מכן, אתה רוצה להגדיר ראשים או רגלים שונים עבור מוזר ואפילו דפים במסמך. כדי לעשות זאת, עליך להגדיר את odd_and_even_pages_header_footer דגל true ואז להבין את הערכים HeaderPrimary ו HeaderEven, או FooterPrimary ו FooterEven.

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.page_setup.odd_and_even_pages_header_footer = True
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_EVEN)
builder.write("Header for even pages.")
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_PRIMARY)
builder.write("Header for odd pages.")
builder.move_to_header_footer(aw.HeaderFooterType.FOOTER_EVEN)
builder.write("Footer for even pages.")
builder.move_to_header_footer(aw.HeaderFooterType.FOOTER_PRIMARY)
builder.write("Footer for odd pages.")
builder.move_to_section(0)
builder.writeln("Page 1")
builder.insert_break(aw.BreakType.PAGE_BREAK)
builder.writeln("Page 2")
doc.save(ARTIFACTS_DIR + "WorkingWithHeadersAndFooters.odd_even_pages.docx")

הכנס מיקום מוחלט צילום: The Header

כדי להציב תמונה בראש או ברגל, השתמש HeaderPrimary סוג ראש או FooterPrimary סוג כף הרגל וה insert_image שיטה.

הדוגמה הבאה של הקוד מראה כיצד להוסיף תמונה לראש:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_PRIMARY)
builder.insert_image(IMAGES_DIR + "Logo.jpg",
aw.drawing.RelativeHorizontalPosition.RIGHT_MARGIN,
10, aw.drawing.RelativeVerticalPosition.PAGE, 10, 50, 50,
aw.drawing.WrapType.THROUGH)
doc.save(ARTIFACTS_DIR + "WorkingWithHeadersAndFooters.insert_image.docx")
view raw insert-image.py hosted with ❤ by GitHub

עם Aspose.Words באפשרותך להגדיר את התכונות של הגופן והפסקה, השתמש HeaderPrimary סוג ראש או FooterPrimary סוג כף הרגל, כמו גם שיטות ונכסים לעבודה עם גופנים ופסקאות אתה משתמש עבור גוף המסמך.

הדוגמה הבאה של הקוד מראה כיצד להגדיר את הטקסט בראש אריאל, נועז, בגודל 14, והיערכות מרכזית:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_PRIMARY)
builder.paragraph_format.alignment = aw.ParagraphAlignment.CENTER
builder.font.name = "Arial"
builder.font.bold = True
builder.font.size = 14
builder.write("Header for pages.")
doc.save(ARTIFACTS_DIR + "WorkingWithHeadersAndFooters.font_props.docx")
view raw font-props.py hosted with ❤ by GitHub

אם יש צורך, באפשרותך להוסיף מספרי דף לראש או ל Footer. לעשות זאת, השתמש HeaderPrimary סוג ראש או FooterPrimary סוג כף הרגל וה insert_field שיטה להוסיף את השדה הנדרש.

הדוגמה הבאה של הקוד מראה כיצד להוסיף מספרי דף לכף הרגל מימין:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.move_to_header_footer(aw.HeaderFooterType.FOOTER_PRIMARY)
builder.paragraph_format.alignment = aw.ParagraphAlignment.CENTER
builder.write("Page ")
builder.insert_field("PAGE", "")
builder.write(" of ")
builder.insert_field("NUMPAGES", "")
doc.save(ARTIFACTS_DIR + "WorkingWithHeadersAndFooters.page_numbers.docx")
view raw page-numbers.py hosted with ❤ by GitHub

השתמש ב Headers או Footers Defined בסעיף הקודם

אם אתה צריך להעתיק את ראש או רגל מן החלק הקודם, אתה יכול לעשות את זה גם.

הדוגמה הבאה של הקוד מראה כיצד להעתיק את הפנר או את הרגל מהחלק הקודם:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
@staticmethod
def copy_headers_footers_from_previous_section(section):
"""Clones and copies headers/footers form the previous section to the specified section."""
previous_section = section.previous_sibling.as_section()
if previous_section is None:
return
section.headers_footers.clear()
for header_footer in previous_section.headers_footers:
section.headers_footers.add(header_footer.clone(True))

Aspose.Words מאפשר לך לספק את המראה של Header או Footer בעת שימוש בכיוונים שונים וגדלי דף.

הדוגמה הבאה מראה כיצד לעשות זאת:

כיצד להסיר רק ראשים או רק רגליים

כל קטע במסמך יכול להיות עד שלושה ראשים ועד שלושה הולכי רגל (לראשונה, אפילו, ודפים מוזרים). אם אתה רוצה להסיר את כל הראשים או כל ההולכי רגל במסמך, אתה צריך לחדור דרך כל הקטעים ולהסיר כל צומת ראש או צומת כף רגל מתאימה.

הדוגמה הקודית הבאה מראה כיצד להסיר את כל ההולכי הרגל מכל הסעיפים, אך להשאיר ראשים שלמים. ניתן להסיר רק ראשים באופן דומה:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET.git.
doc = aw.Document(MY_DIR + "Header and footer types.docx")
for section in doc:
section = section.as_section()
# Up to three different footers are possible in a section (for first, even and odd pages)
# we check and delete all of them.
footer = section.headers_footers.get_by_header_footer_type(aw.HeaderFooterType.FOOTER_FIRST)
if footer is not None:
footer.remove()
# Primary footer is the footer used for odd pages.
footer = section.headers_footers.get_by_header_footer_type(aw.HeaderFooterType.FOOTER_PRIMARY)
if footer is not None:
footer.remove()
footer = section.headers_footers.get_by_header_footer_type(aw.HeaderFooterType.FOOTER_EVEN)
if footer is not None:
footer.remove()
doc.save(ARTIFACTS_DIR + "RemoveContent.remove_footers.docx")