การทำงานกับส่วนหัวและท้ายกระดาษ

Aspose.Wordsอนุญาตให้ผู้ใช้ทำงานกับส่วนหัวและท้ายกระดาษในเอกสาร ส่วนหัวคือข้อความที่วางไว้ที่ด้านบนของหน้าและส่วนท้ายเป็นข้อความที่ด้านล่างของหน้า โดยปกติแล้วพื้นที่เหล่านี้จะใช้ในการแทรกข้อมูลที่ควรจะทำซ้ำในทั้งหมดหรือบางหน้าของ.

สร้างส่วนหัวหรือท้ายกระดาษโดยใช้DocumentBuilder

หากคุณต้องการเพิ่มส่วนหัวหรือส่วนท้ายของเอกสารโดยใช้โปรแกรม วิธีที่ง่ายที่สุดคือใช้คลาส DocumentBuilder ในการดำเนินการ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มส่วนหัวและท้ายกระดาษสำหรับหน้าเอกสาร:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	// Use HeaderPrimary and FooterPrimary
	// if you want to set header/footer for all document.
	// This header/footer type also responsible for odd pages.
	builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
	builder->Write(u"Header for page.");

	builder->MoveToHeaderFooter(HeaderFooterType::FooterPrimary);
	builder->Write(u"Footer for page.");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.CreateHeaderFooter.docx");

view raw create-header-footer.h hosted with ❤ by GitHub

ระบุตัวเลือกส่วนหัวหรือส่วนท้าย

เมื่อคุณเพิ่มส่วนหัวหรือท้ายกระดาษลงในเอกสารคุณสามารถตั้งค่าคุณสมบัติขั้นสูงบางอย่า Aspose.Wordsให้ผู้ใช้ที่มีHeaderFooterและHeaderFooterCollectionชั้นเรียน,เช่นเดียวกับHeaderFooterTypeนับที่ให้คุณควบคุมมากขึ้นกว่าส่วนหัวและส่วนท้าย.

ระบุประเภทส่วนหัวหรือส่วนท้าย

คุณสามารถระบุสามประเภทส่วนหัวที่แตกต่างกันและสามชนิดส่วนท้ายที่แตกต่างกันสำหรั:

ส่วนหัวและ/หรือส่วนท้ายสำหรับหน้าแรก
ส่วนหัวและ/หรือส่วนท้ายสำหรับหน้าแม้แต่
ส่วนหัวและ/หรือส่วนท้ายสำหรับหน้าคี่

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มส่วนหัวสำหรับหน้าเอกสารคี่:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
	builder->Write(u"Header for page.");

view raw header-footer-type.h hosted with ❤ by GitHub

ระบุว่าจะแสดงส่วนหัวหรือท้ายกระดาษที่แตกต่างกันสำหรับหน้าแรก

ดังกล่าวข้างต้นคุณยังสามารถตั้งค่าส่วนหัวที่แตกต่างกันหรือส่วนท้ายสำหรับหน้าแรก งค่าDifferentFirstPageHeaderFooterเป็นtrueแล้วระบุค่าHeaderFirstหรือFooterFirst.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการตั้งค่าส่วนหัวสำหรับหน้าแรกเท่านั้น:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	// Specify that we want different headers and footers for first page.
	builder->get_PageSetup()->set_DifferentFirstPageHeaderFooter(true);

	builder->MoveToHeaderFooter(HeaderFooterType::HeaderFirst);
	builder->Write(u"Header for the first page.");
	builder->MoveToHeaderFooter(HeaderFooterType::FooterFirst);
	builder->Write(u"Footer for the first page.");

	builder->MoveToSection(0);
	builder->Writeln(u"Page 1");
	builder->InsertBreak(BreakType::PageBreak);
	builder->Writeln(u"Page 2");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.DifferentFirstPage.docx");

view raw different-first-page.h hosted with ❤ by GitHub

ระบุว่าจะแสดงส่วนหัวหรือท้ายกระดาษที่แตกต่างกันสำหรับหน้าคี่หรือคู่

ถัดไปคุณจะต้องการตั้งค่าส่วนหัวหรือส่วนท้ายที่แตกต่างกันสำหรับหน้าคี่และแม้ในเอกสาร งค่าOddAndEvenPagesHeaderFooterเป็นtrueแล้วระบุค่าHeaderPrimaryและHeaderEvenหรือFooterPrimaryและFooterEven.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	// Specify that we want different headers and footers for even and odd pages.
	builder->get_PageSetup()->set_OddAndEvenPagesHeaderFooter(true);

	builder->MoveToHeaderFooter(HeaderFooterType::HeaderEven);
	builder->Write(u"Header for even pages.");
	builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
	builder->Write(u"Header for odd pages.");
	builder->MoveToHeaderFooter(HeaderFooterType::FooterEven);
	builder->Write(u"Footer for even pages.");
	builder->MoveToHeaderFooter(HeaderFooterType::FooterPrimary);
	builder->Write(u"Footer for odd pages.");

	builder->MoveToSection(0);
	builder->Writeln(u"Page 1");
	builder->InsertBreak(BreakType::PageBreak);
	builder->Writeln(u"Page 2");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.OddEvenPages.docx");

view raw odd-even-pages.h hosted with ❤ by GitHub

แทรกภาพตำแหน่งอย่างลงในส่วนหัว

ในการวางรูปภาพในส่วนหัวหรือส่วนท้ายให้ใช้HeaderPrimaryชนิดส่วนหัวหรือFooterPrimaryชนิดส่วนท้ายและวิธีการInsertImage.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มรูปภาพไปยังส่วนหัว:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
+auto doc = MakeObject<Document>();
+auto builder = MakeObject<DocumentBuilder>(doc);
+builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
+builder->InsertImage(ImagesDir + u"Logo.jpg", RelativeHorizontalPosition::RightMargin, 10,
+    RelativeVerticalPosition::Page, 10, 50, 50, WrapType::Through);
+doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.InsertImage.docx");

view raw insert-image.h 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-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
	builder->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Center);
	builder->get_Font()->set_Name(u"Arial");
	builder->get_Font()->set_Bold(true);
	builder->get_Font()->set_Size(14);
	builder->Write(u"Header for page.");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.FontProps.docx");

view raw font-props.h hosted with ❤ by GitHub

แทรกหมายเลขหน้าลงในส่วนหัวหรือส่วนท้าย

หากจำเป็นคุณสามารถเพิ่มหมายเลขหน้าไปยังส่วนหัวหรือส่วนท้าย เมื่อต้องการทำเช่นนี้ให้ใช้HeaderPrimaryชนิดส่วนหัวหรือFooterPrimaryชนิดส่วนท้ายและวิธีการInsertFieldเพื่อเพิ่มฟิลด์ที่ต้องการ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการเพิ่มหมายเลขหน้าไปยังส่วนท้ายด้านขวา:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	builder->MoveToHeaderFooter(HeaderFooterType::FooterPrimary);
	builder->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Right);
	builder->Write(u"Page ");
	builder->InsertField(u"PAGE", u"");
	builder->Write(u" of ");
	builder->InsertField(u"NUMPAGES", u"");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.PageNumbers.docx");

view raw page-numbers.h hosted with ❤ by GitHub

ใช้ส่วนหัวหรือท้ายกระดาษที่กำหนดไว้ในส่วนก่อนหน้า

ถ้าคุณต้องการคัดลอกส่วนหัวหรือส่วนท้ายจากส่วนก่อนหน้านี้,คุณสามารถทำเช่นนั้นมากเกิน.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการคัดลอกส่วนหัวหรือส่วนท้ายจากส่วนก่อนหน้า:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	/// <summary>
	/// Clones and copies headers/footers form the previous section to the specified section.
	/// </summary>
	void CopyHeadersFootersFromPreviousSection(SharedPtr<Section> section)
	{
	auto previousSection = System::ExplicitCast<Section>(section->get_PreviousSibling());

	if (previousSection == nullptr)
	{
	return;
	}

	section->get_HeadersFooters()->Clear();

	for (const auto& headerFooter : System::IterateOver<HeaderFooter>(previousSection->get_HeadersFooters()))
	{
	section->get_HeadersFooters()->Add((System::ExplicitCast<Node>(headerFooter))->Clone(true));
	}
	}

view raw copy-headers-footers-from-previous-section.h hosted with ❤ by GitHub

ให้แน่ใจว่าลักษณะส่วนหัวหรือส่วนท้ายเมื่อใช้ทิศทางหน้าแตกต่างกันและขนาดหน้า

Aspose.Wordsช่วยให้คุณสามารถให้ลักษณะที่ปรากฏของส่วนหัวหรือส่วนท้ายเมื่อใช้ทิศทางที่แตกต่างกันแ.

ตัวอย่างต่อไปนี้แสดงวิธีการทำเช่นนี้:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
	auto doc = MakeObject<Document>();
	auto builder = MakeObject<DocumentBuilder>(doc);

	builder->get_PageSetup()->set_DifferentFirstPageHeaderFooter(true);

	builder->MoveToHeaderFooter(HeaderFooterType::HeaderFirst);
	builder->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Center);
	builder->get_Font()->set_Name(u"Arial");
	builder->get_Font()->set_Bold(true);
	builder->get_Font()->set_Size(14);
	builder->Write(u"Header for the first page.");

	builder->MoveToDocumentEnd();
	builder->InsertBreak(BreakType::SectionBreakNewPage);

	auto currentSection = builder->get_CurrentSection();
	auto pageSetup = currentSection->get_PageSetup();
	pageSetup->set_Orientation(Orientation::Landscape);
	// This section does not need a different first-page header/footer we need only one title page in the document,
	// and the header/footer for this page has already been defined in the previous section.
	pageSetup->set_DifferentFirstPageHeaderFooter(false);

	// This section displays headers/footers from the previous section
	// by default call currentSection.HeadersFooters.LinkToPrevious(false) to cancel this page width
	// is different for the new section.
	currentSection->get_HeadersFooters()->LinkToPrevious(false);
	currentSection->get_HeadersFooters()->Clear();

	builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
	builder->get_ParagraphFormat()->set_Alignment(ParagraphAlignment::Center);
	builder->get_Font()->set_Name(u"Arial");
	builder->get_Font()->set_Size(12);
	builder->Write(u"New Header for the first page.");

	doc->Save(ArtifactsDir + u"WorkingWithHeadersAndFooters.LinkToPreviousHeaderFooter.docx");

view raw link-to-previous-header-footer.h hosted with ❤ by GitHub

วิธีการลบเฉพาะส่วนหัวหรือส่วนท้ายเท่านั้น

แต่ละส่วนในเอกสารสามารถมีได้ถึงสามส่วนหัวและถึงสามส่วนท้าย(สำหรับหน้าแรกแม้และ ถ้าคุณต้องการลบส่วนหัวทั้งหมดหรือท้ายกระดาษทั้งหมดในเอกสารคุณต้องวนรอบผ่านทุกส่.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการลบส่วนท้ายกระดาษทั้งหมดจากทุกส่วนแต่ปล่อยส่วนหัวเห คุณสามารถลบเฉพาะส่วนหัวในลักษณะที่คล้ายกัน:

-// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C.git.
-auto doc = MakeObject<Document>(MyDir + u"Header and footer types.docx");
-for (const auto& section : System::IterateOver<Section>(doc))
-{
-    // Up to three different footers are possible in a section (for first, even and odd pages)
-    // we check and delete all of them.
-    SharedPtr<HeaderFooter> footer = section->get_HeadersFooters()->idx_get(HeaderFooterType::FooterFirst);
-    if (footer != nullptr)
-    {
-        footer->Remove();
-    }
-    // Primary footer is the footer used for odd pages.
-    footer = section->get_HeadersFooters()->idx_get(HeaderFooterType::FooterPrimary);
-    if (footer != nullptr)
-    {
-        footer->Remove();
-    }
-    footer = section->get_HeadersFooters()->idx_get(HeaderFooterType::FooterEven);
-    if (footer != nullptr)
-    {
-        footer->Remove();
-    }
-}
-doc->Save(ArtifactsDir + u"RemoveContent.RemoveFooters.docx");

view raw remove-footers.h hosted with ❤ by GitHub

คุณสามารถดาวน์โหลดไฟล์ตัวอย่างของตัวอย่างนี้ได้จาก Aspose.Words GitHub.

วิธีการแยกเนื้อหาระหว่างโหนดเอกสาร การทำงานกับเชิงอรรถและหมายเหตุในC++