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

موضوعات زیر به اختصار مورد بحث قرار گرفته است:

Java API برای حاشیه نویسی و نشانه گذاری فایل های Word

GroupDocs.Annotation Java API را برای مقابله با حاشیه نویسی ها فراهم می کند. API امکان اضافه کردن، حذف و استخراج حاشیه نویسی از اسناد Word و بسیاری از فرمت های فایل دیگر را فراهم می کند. قالب‌های سند پشتیبانی شده شامل؛ صفحات گسترده، ارائه ها، تصاویر، فایل های PDF، صفحات وب، پیام های ایمیل، نقشه های Visio.

دانلود یا پیکربندی کنید

فایل JAR را از بخش دانلودها دانلود کنید یا فقط آخرین تنظیمات مخزن و وابستگی را برای pom.xml برنامه های Java مبتنی بر maven خود دریافت کنید.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>21.7.2</version> 
</dependency>

اضافه کردن حاشیه نویسی به Word در Java

بیایید انواع مختلف حاشیه نویسی را به اسناد Word اضافه کنیم. حاشیه نویسی انواع مختلفی دارد، بنابراین ما در اینجا تنها به چند مورد اشاره خواهیم کرد.

اضافه کردن حاشیه نویسی به DOC DOCX با استفاده از GroupDocs API

حاشیه نویسی پیکان را به Word در Java اضافه کنید

مراحل زیر برای افزودن حاشیه نویسی فلش به سند Word در Java آمده است.

  • سند را با استفاده از کلاس Annotator بارگیری کنید.
  • حاشیه نویسی پیکان را با کلاس ArrowAnnotation اولیه کنید.
  • موقعیت، اندازه، شماره صفحه حاشیه نویسی فلش را تنظیم کنید.
  • حاشیه نویسی پیکان ایجاد شده را با استفاده از متد add() اضافه کنید.
  • سند Word مشروح شده را با استفاده از روش save() مناسب در مسیر ذخیره کنید.

نمونه کد Java زیر نحوه اضافه کردن حاشیه نویسی فلش را به سند Word نشان می دهد.

// حاشیه نویسی پیکان را به اسناد Word در Java اضافه کنید
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
حاشیه نویسی پیکان را به صورت برنامه نویسی در Java و .NET اضافه کنید

مستطیل یا حاشیه نویسی ناحیه را در ورد در Java درج کنید

مراحل زیر برای افزودن حاشیه نویسی مستطیل یا ناحیه به یک سند DOC/DOCX با برخی تنظیمات سفارشی ارائه شده است. این شبیه به اضافه کردن حاشیه نویسی Arrow است اما از AreaAnnotation استفاده می کند.

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

نمونه کد Java زیر نحوه اضافه کردن حاشیه نویسی مستطیل/ناحیه را به سند Word نشان می دهد.

// اضافه کردن ناحیه یا مستطیل حاشیه نویسی در اسناد Word در جاوا

final Annotator annotator = new Annotator("path/document.docx");

AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
Rectangle یا Area Annotation را به صورت برنامه ریزی شده در .NET و Java اضافه کنید

اضافه کردن حاشیه نویسی بیضی یا بیضی به Word در Java

در زیر مراحل اضافه کردن حاشیه نویسی بیضی/بیضی به یک سند در Java آمده است.

  • سند DOC/DOCX را با استفاده از کلاس Annotator بارگیری کنید.
  • با استفاده از کلاس EllipseAnnotation حاشیه نویسی بیضی را راه اندازی کنید.
  • موقعیت و اندازه حاشیه نویسی بیضی اولیه را تنظیم کنید.
  • حاشیه نویسی بیضی ایجاد شده را به Annotator اضافه کنید.
  • فایل ورد مشروح شده را با استفاده از روش save() مناسب ذخیره کنید.

نمونه کد Java زیر نحوه اضافه کردن حاشیه نویسی بیضی/بیضی به هر سند Word را نشان می دهد.

// اضافه کردن حاشیه نویسی بیضی یا بیضی در اسناد Word در جاوا
final Annotator annotator = new Annotator("path/document.docx");

EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
بیضی یا حاشیه نویسی بیضی را به صورت برنامه ریزی شده در C#.NET و Java اضافه کنید

حاشیه نویسی فاصله را در ورد در Java درج کنید

به همین ترتیب، می توانید فاصله بین دو نقطه را با استفاده از حاشیه نویسی فاصله ذکر کنید. در زیر مراحل اضافه کردن حاشیه نویسی فاصله به سند در Java آمده است.

  • پس از بارگیری سند Word، حاشیه نویسی فاصله را با استفاده از کلاس DistanceAnnotation مقداردهی اولیه کنید.
  • ظاهر حاشیه نویسی را تنظیم کنید.
  • حاشیه نویسی فاصله را به شی Annotator اضافه کنید.
  • سند مشروح را در مکان مشخص ذخیره کنید یا از روش save() مناسب استفاده کنید.

نمونه کد Java زیر نحوه اضافه کردن حاشیه نویسی فاصله را به یک سند DOC/DOCX نشان می دهد.

// اضافه کردن حاشیه نویسی فاصله به اسناد Word در جاوا
final Annotator annotator = new Annotator("path/document.docx");

DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
اضافه کردن حاشیه نویسی فاصله به صورت برنامه ای در C#.NET و جاوا

حاشیه نویسی ها را از فایل های Word DOC/DOCX در Java حذف کنید

راه های زیادی برای حذف حاشیه نویسی از اسناد Word وجود دارد. شما می توانید حاشیه نویسی های خاص را با ارائه نمایه هایی برای حذف حاشیه نویسی های خاص حذف کنید. علاوه بر این، می توانید تمام حاشیه نویسی ها را یکجا حذف کنید. جزئیات و کد منبع Java برای حذف حاشیه نویسی در یک مقاله جداگانه مورد بحث قرار گرفته است.

مراحل زیر برای حذف تمام حاشیه نویسی ها از یک فایل Word است.

کد زیر نحوه حذف حاشیه نویسی از فایل Word در Java را نشان می دهد.

// تمام حاشیه نویسی ها را از سند Word در Java حذف کنید
final Annotator annotator = new Annotator("path/annotatedDoc.docx");

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);

نتیجه

به طور خلاصه، یاد گرفته‌اید که چگونه در برنامه‌های Java به اسناد Word حاشیه‌نویسی اضافه کنید. به طور خاص، با استفاده از GroupDocs.Annotation for Java، حاشیه‌نویسی‌های پیکان، بیضی، ناحیه و فاصله را به فایل Word DOC/DOCX اضافه کردیم. علاوه بر این، نحوه حذف تمام حاشیه نویسی ها از هر فایل Word را نیز مشاهده کرده اید. اکنون، می‌توانید برنامه Java حاشیه‌نویس اسناد خود را بسازید.

در مورد API از documentation و مخزن GitHub بیشتر بیاموزید. برای سوالات بیشتر، با پشتیبانی در فروم تماس بگیرید.

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