سرصفحه و پاورقی معمولاً در اسناد برای نشان دادن اطلاعات مهم مانند شماره صفحه، موضوع، فصل و غیره استفاده می شود. برنامه های جاوا شما در این مقاله با اضافه کردن یا حذف هدر و پاورقی آشنا می شویم. در زیر موضوعاتی وجود دارد که به تفصیل بررسی خواهیم کرد:

درج یا حذف Header Footer API – نصب

برای کار با Header و Footer در اسناد Word، از Aspose.Words for Java API استفاده خواهیم کرد که در آن فراخوانی های ساده API به ما در دستیابی به الزامات کمک می کند. می‌توانید فایل JAR را از [بخش انتشار] دانلود کنید، یا پیکربندی‌های Maven زیر را در پروژه خود کپی کنید. API از طریق مخزن Maven پیکربندی خواهد شد و شما خوب خواهید بود که مراحل بعدی توضیح داده شده در این مقاله را ادامه دهید.

مخزن:

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.com/repo/</url>
    </repository>
</repositories>

وابستگی:

<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words</artifactId>
        <version>20.8</version>
        <classifier>jdk17</classifier>
    </dependency>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words</artifactId>
        <version>20.8</version>
        <classifier>javadoc</classifier>
    </dependency>
</dependencies>

هدر و پاورقی را در سند Word (DOCX/DOC) با استفاده از جاوا اضافه کنید

افزودن سرصفحه و پاورقی در اسناد Word (DOCX/DOC) یک مورد اساسی و در عین حال مهم برای کار با اسناد پردازش کلمه است. با این حال، سناریوهای مختلف ممکن است. به عنوان مثال، ممکن است لازم باشد یک تصویر، یک جدول یا فقط مقداری متن در قسمت سرصفحه و پاورقی اضافه کنید. علاوه بر این، گاهی اوقات سرصفحه و پاورقی در صفحه عنوان در مقایسه با سایر صفحات متفاوت است. گاهی اوقات سرصفحه و پاورقی در شماره صفحات زوج متفاوت است و در شماره صفحات فرد متفاوت است. بنابراین، ما یک مثال مختصر و اساسی از افزودن سربرگ و پاورقی در اسناد Word ایجاد کرده ایم.

در اینجا ما فوتر هدر متفاوتی را در صفحه عنوان (در صفحه اول) و پاورقی هدر متفاوتی را در صفحه بعدی وارد می کنیم. در حالی که صفحه دوم دارای یک فوتر هدر سفارشی شامل تصویر، متن و عنصر جدول خواهد بود. برای افزودن یا درج هدر و پاورقی در اسناد word (DOCX/DOC) با استفاده از جاوا باید مراحل زیر را دنبال کنید.

  1. اشیاء کلاس Document و DocumentBuilder را مقداردهی اولیه کنید
  2. مشخص کنید که فوتر سرصفحه متفاوتی برای صفحه عنوان می خواهید
  3. ویژگی های فونت را برای متن سرصفحه تنظیم کنید
  4. هدر و برای صفحات بعدی ایجاد کنید
  5. جدول را وارد کنید و قالب شماره صفحه را تنظیم کنید
  6. فایل خروجی DOCX را ذخیره کنید

کد زیر بر اساس این مراحل است که نحوه اضافه کردن سرصفحه و پاورقی در اسناد Word (DOCX/DOC) را به صورت برنامه‌نویسی با استفاده از جاوا نشان می‌دهد:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Section currentSection = builder.getCurrentSection();
PageSetup pageSetup = currentSection.getPageSetup();

// مشخص کنید که آیا می خواهیم سرصفحه/پانویس صفحه اول با سایر صفحات متفاوت باشد.
// همچنین می توانید از ویژگی PageSetup.OddAndEvenPagesHeaderFooter برای تعیین استفاده کنید
// سرصفحه/پانویس های مختلف برای صفحات زوج و فرد.
pageSetup.setDifferentFirstPageHeaderFooter(true);

// --- برای صفحه اول هدر ایجاد کنید. ---
pageSetup.setHeaderDistance(20);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_FIRST);
builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);

// ویژگی های فونت را برای متن سرصفحه تنظیم کنید.
builder.getFont().setName("Arial");
builder.getFont().setBold(true);
builder.getFont().setSize(14);
// عنوان سرصفحه را برای صفحه اول مشخص کنید.
builder.write("Aspose.Words Header/Footer Creation - Title Page.");

// --- برای صفحاتی غیر از صفحه اول سرصفحه ایجاد کنید. ---
pageSetup.setHeaderDistance(20);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_PRIMARY);

// تصویر کاملاً با موقعیت را در گوشه بالا/چپ هدر قرار دهید.
// فاصله از لبه های بالا/چپ صفحه روی 10 نقطه تنظیم شده است.
String imageFileName = dataDir + "Aspose.Words.gif";
builder.insertImage(imageFileName, RelativeHorizontalPosition.PAGE, 10, RelativeVerticalPosition.PAGE, 10, 50, 50, WrapType.THROUGH);

builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
// عنوان سرصفحه دیگری را برای صفحات دیگر مشخص کنید.
builder.write("Aspose.Words Header/Footer Creation");

// --- برای صفحاتی غیر از صفحه اول فوتر ایجاد کنید. ---
builder.moveToHeaderFooter(HeaderFooterType.FOOTER_PRIMARY);

// برای ساختن یک قسمت از متن روی خط (با شماره گذاری صفحه) از جدول با دو خانه استفاده می کنیم.
// به سمت چپ تراز شود و قسمت دیگر متن (با حق چاپ) به سمت راست تراز شود.
builder.startTable();

// مرزهای جدول را پاک کنید
builder.getCellFormat().clearFormatting();

builder.insertCell();
// سلول اول را روی 1/3 عرض صفحه تنظیم کنید.
builder.getCellFormat().setPreferredWidth(PreferredWidth.fromPercent(100 / 3));

// متن شماره گذاری صفحه را در اینجا درج کنید.
// از فیلدهای PAGE و NUMPAGES برای محاسبه خودکار شماره صفحه فعلی و تعداد کل صفحات استفاده می کند.
builder.write("Page ");
builder.insertField("PAGE", "");
builder.write(" of ");
builder.insertField("NUMPAGES", "");

// این متن را در سمت چپ تراز کنید.
builder.getCurrentParagraph().getParagraphFormat().setAlignment(ParagraphAlignment.LEFT);

builder.insertCell();
// سلول دوم را روی 2/3 عرض صفحه قرار دهید.
builder.getCellFormat().setPreferredWidth(PreferredWidth.fromPercent(100 * 2 / 3));

builder.write("(C) 2020 Aspose Pty Ltd. All rights reserved.");

// این متن را در سمت راست تراز کنید.
builder.getCurrentParagraph().getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);

builder.endRow();
builder.endTable();

builder.moveToDocumentEnd();
// برای ایجاد صفحه دوم که در آن سرصفحه ها/پانویس های اصلی دیده می شود، صفحه را شکست دهید.
builder.insertBreak(BreakType.PAGE_BREAK);

// سند حاصل را ذخیره کنید.
doc.save(dataDir + "HeaderFooter_Out.docx");

تا اینجا ما یاد گرفتیم که چگونه هدر و پاورقی را در فایل های word اضافه یا درج کنیم. در زیر تصویری از نحوه ظاهر خروجی هنگام مشاهده آن از طریق گزینه Print Preview مشاهده می شود.

این ویژگی زمانی که اسناد مختلف DOC/DOCX توسط برنامه‌های شما پردازش می‌شوند و می‌خواهید محتوایی را به عنوان فوتر سرصفحه اسناد خروجی اضافه کنید، بسیار کمک می‌کند.

افزودن یا حذف پاورقی سرصفحه

اجازه دهید به بررسی حذف هدر و پاورقی از فایل های MS Word (DOCX/DOC) بپردازیم.

هدر و پاورقی سند ورد (DOCX/DOC) را با استفاده از جاوا حذف کنید

با استفاده از Aspose.Words for Java API می توانید هدر و همچنین پاورقی اسناد word را حذف کنید. همانطور که در بالا توضیح داده شد، سه نوع مختلف سرصفحه و پاورقی می تواند در یک سند اضافه شود. به عنوان مثال، در صفحه عنوان، در صفحات زوج و شماره صفحات فرد. شما می توانید تمام سرصفحه ها و پاورقی ها را در یک فایل word به سادگی با انجام مراحل زیر حذف کنید:

  1. فایل منبع DOCX/DOC را بارگیری کنید
  2. سرصفحه و پاورقی را در صفحه عنوان، شماره صفحات زوج و شماره صفحات فرد پیدا کنید
  3. پس از یافتن بخش مورد نیاز را حذف کنید
  4. فایل خروجی DOCX را ذخیره کنید

کد زیر این مراحل را دنبال می کند و نحوه حذف هدر و پاورقی در اسناد word را با استفاده از جاوا نشان می دهد:

Document doc = new Document(dataDir + "HeaderFooter.doc");
for (Section section : doc.getSections()) {
	// حداکثر سه فوتر هدر مختلف در یک بخش (برای صفحات اول، زوج و فرد) امکان پذیر است.
	// همه آنها را بررسی و حذف می کنیم.
	HeaderFooter footer;
        HeaderFooter header;

	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_FIRST);
       	header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_FIRST);
        
        
	if (footer != null)
		footer.remove();
        
        	if (header != null)
		header.remove();

	// پاورقی هدر اصلی برای صفحات فرد استفاده می شود.
	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_PRIMARY);
	if (footer != null)
		footer.remove();
        
        header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_PRIMARY);
	if (header != null)
		header.remove();

	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_EVEN);
	if (footer != null)
		footer.remove();
        
       	header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_EVEN);
	if (header != null)
		header.remove();
}

doc.save(dataDir + "RemoveHeaderFooter_Out.docx");

پاورقی را از سند Word (DOCX/DOC) با استفاده از جاوا حذف کنید

قبلاً در مورد نحوه حذف یا حذف هدر و پاورقی از فایل های word بحث کرده ایم. با این حال، ممکن است بخواهید فقط پاورقی های یک سند Word را حذف کنید در حالی که سربرگ دست نخورده باقی بماند. این الزامات به راحتی با مراحل زیر امکان پذیر است:

  1. بارگیری فایل word منبع (DOCX/DOC)
  2. در هر بخش از سند word تکرار کنید
  3. شیء HeaderFooter را مقداردهی کنید
  4. پاورقی را از فایل ورودی حذف کنید
  5. فایل DOCX/DOC به روز شده را ذخیره کنید

قطعه کد زیر نحوه حذف پاورقی از سند word با استفاده از جاوا را توضیح می دهد:

Document doc = new Document(dataDir + "HeaderFooter.doc");
for (Section section : doc.getSections()) {
	// حداکثر سه فوتر مختلف در یک بخش (برای صفحات اول، زوج و فرد) امکان پذیر است.
	// همه آنها را بررسی و حذف می کنیم.
	HeaderFooter footer;

	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_FIRST);
	if (footer != null)
		footer.remove();

	// فوتر اصلی پاورقی است که برای صفحات فرد استفاده می شود.
	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_PRIMARY);
	if (footer != null)
		footer.remove();

	footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_EVEN);
	if (footer != null)
		footer.remove();
}
doc.save(dataDir + "RemoveFooters.docx");

هدر را از سند ورد (DOCX/DOC) با استفاده از جاوا حذف کنید

از آنجایی که یاد گرفته ایم فقط پاورقی را از فایل های MS Word حذف یا حذف کنیم. اجازه دهید این مرحله را بیشتر بررسی کنیم، جایی که ممکن است لازم باشد فقط سرصفحه ها را از اسناد Word حذف کنید. پاورقی ها یکسان و بدون تاثیر باقی می مانند زیرا تمرکز ما در اینجا فقط حذف هدرها است. مراحل زیر یک طرح کلی از روشی را که برای این منظور اتخاذ می شود ارائه می دهد:

  1. بارگیری فایل ورد ورودی (DOCX/DOC)
  2. نمونه ای از کلاس HeaderFooter را راه اندازی کنید
  3. هدرها را از تمام بخش های سند ورودی حذف کنید
  4. فایل DOCX به روز رسانی را ذخیره کنید

کد زیر نحوه حذف یا حذف هدر اسناد word را با استفاده از جاوا نشان می دهد:

Document doc = new Document(dataDir + "HeaderFooter.doc");
for (Section section : doc.getSections()) {
	// حداکثر سه فوتر مختلف در یک بخش (برای صفحات اول، زوج و فرد) امکان پذیر است.
	// همه آنها را بررسی و حذف می کنیم.
	HeaderFooter header;

	header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_FIRST);
	if (header != null)
		header.remove();

	// فوتر اصلی پاورقی است که برای صفحات فرد استفاده می شود.
	header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_PRIMARY);
	if (header != null)
		header.remove();

	header = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.HEADER_EVEN);
	if (header != null)
		header.remove();
}
doc.save(dataDir + "RemoveHeader.docx");

نتیجه

افزودن، درج، حذف یا حذف سربرگ و پاورقی در اسناد Word یکی از موارد استفاده بسیار مهم و مکرر در پردازش کلمه است. تقریباً همه اسناد حاوی سرصفحه ها و پاورقی ها هستند که می توانند با Aspose.Words برای Java API مطابق با نیاز شما دستکاری شوند. این مقاله مروری بر ویژگی‌های مرتبط است که در آن می‌توانید در مورد هر مورد استفاده سفارشی و الزامات از طریق تالارهای پشتیبانی رایگان با ما صحبت کنید. برای هر گونه سوال و نگرانی با ما تماس بگیرید.

همچنین ببینید