اضافه کردن یا حذف حاشیه نویسی از فایل های PDF با استفاده از جاوا

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

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

Java API برای کار با حاشیه نویسی در PDF
اضافه کردن حاشیه نویسی به PDF در جاوا
حاشیه نویسی ها را از PDF در Java حذف کنید

PDF Annotator Java API

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

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

کتابخانه حاشیه نویسی را از دانلودها دریافت کنید یا فقط پیکربندی pom.xml زیر را در برنامه‌های Java مبتنی بر Maven خود اضافه کنید تا نمونه‌های این مقاله و همچنین بسیاری از نمونه‌های موجود در GitHub را امتحان کنید. برای جزئیات، می توانید از مرجع API دیدن کنید.

<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>20.2</version> 
</dependency>

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

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

حاشیه نویسی ناحیه / مستطیل
فلش
فاصله
بیضی
برجسته
ارتباط دادن
نقطه
پلی لاین
جایگزینی
ویرایش منابع
ضربه زدن
فیلد متن
ویرایش متن
زیر خط بکشید
واترمارک

بیایید شروع کنیم به اضافه کردن برخی از اینها در یک سند PDF.

با استفاده از جاوا، حاشیه نویسی پیکان را به PDF اضافه کنید

مراحل زیر برای افزودن حاشیه نویسی پیکان به یک سند PDF است.

سند PDF را با استفاده از کلاس Annotator بارگیری کنید.
حاشیه نویسی پیکان را با استفاده از کلاس ArrowAnnotation راه اندازی کنید.
موقعیت و اندازه فلش را با استفاده از روش setBox ArrowAnnotation تنظیم کنید.
حاشیه نویسی پیکان ایجاد شده را به شی Annotator اضافه کنید.
PDF مشروح شده را با ارائه مسیر با استفاده از روش save ذخیره کنید.

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

// با استفاده از جاوا، حاشیه نویسی پیکان را به PDF اضافه کنید
final Annotator annotator = new Annotator("document.pdf");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100)); // (x, y, width, height)
annotator.add(arrow);
annotator.save("path/annotated-with-arrow.pdf");

با استفاده از جاوا، مستطیل یا حاشیه نویسی ناحیه را به PDF وارد کنید

شما می توانید هر حاشیه نویسی را هنگام اضافه کردن آن به سند سفارشی کنید. مراحل زیر برای افزودن حاشیه نویسی مستطیل یا ناحیه به یک سند PDF با کمی سفارشی سازی بیشتر است. این شبیه به اضافه کردن حاشیه نویسی Arrow است اما از کلاس AreaAnnotation به جای ArrowAnnotation استفاده می کند.

سند PDF را با استفاده از کلاس Annotator بارگیری کنید.
با استفاده از کلاس AreaAnnotation حاشیه نویسی مستطیل را راه اندازی کنید.
موقعیت و اندازه مستطیل را با استفاده از روش setBox AreaAnnotation تنظیم کنید.
ویژگی های دیگر مانند رنگ، پس زمینه، کدورت، سبک، عرض قلم یا حتی پیام ها و زمان را تنظیم کنید.
حاشیه نویسی مستطیل ایجاد شده را به شی Annotator اضافه کنید.
PDF مشروح شده را با ارائه مسیر با استفاده از روش save ذخیره کنید.

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

// با استفاده از جاوا، حاشیه نویسی ناحیه یا حاشیه نویسی مستطیل را به PDF اضافه کنید
final Annotator annotator = new Annotator("document.pdf");
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
// به سند اضافه کنید
annotator.add(area);
annotator.save("path/annotated-with-rectangle.pdf");

با استفاده از جاوا، حاشیه نویسی بیضی یا بیضی را به PDF اضافه کنید

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

سند PDF را با استفاده از کلاس Annotator بارگیری کنید.
با استفاده از کلاس EllipseAnnotation حاشیه نویسی بیضی را راه اندازی کنید.
موقعیت و اندازه بیضی را با استفاده از روش setBox EllipseAnnotation تنظیم کنید.
حاشیه نویسی بیضی ایجاد شده را به شی Annotator اضافه کنید.
PDF مشروح شده را با ارائه مسیر با استفاده از روش save ذخیره کنید.

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

// با استفاده از جاوا، حاشیه نویسی بیضی یا بیضی را در PDF اضافه کنید
final Annotator annotator = new Annotator("document.pdf");
// حاشیه نویسی بیضی یا بیضی
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
// به سند اضافه کنید
annotator.add(area);
annotator.save("path/annotated-with-ellipse.pdf");

درج حاشیه نویسی فاصله به PDF با استفاده از Java

همچنین می توانید حاشیه نویسی فاصله را برای نشان دادن فاصله بین دو نقطه اضافه کنید. مراحل زیر برای افزودن حاشیه نویسی فاصله به سند PDF است.

سند PDF را با استفاده از کلاس Annotator بارگیری کنید.
حاشیه نویسی فاصله را با استفاده از کلاس DistanceAnnotation راه اندازی کنید.
اندازه و موقعیت حاشیه نویسی را با استفاده از روش setBox DistanceAnnotation تنظیم کنید.
حاشیه نویسی فاصله ایجاد شده را به شی Annotator اضافه کنید.
PDF مشروح شده را با ارائه مسیر با استفاده از روش save ذخیره کنید.

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

// حاشیه نویسی فاصله با استفاده از جاوا
final Annotator annotator = new Annotator("document.pdf");
// حاشیه نویسی فاصله
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
// به سند اضافه کنید
annotator.add(area);
annotator.save("path/annotated-with-distance.pdf");

کد کامل

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

کد زیر، پیکان، مستطیل، بیضی، حاشیه نویسی فاصله، پیام و پاسخ را به یک فایل PDF اضافه می کند.

// با استفاده از جاوا، چندین حاشیه نویسی را به PDF اضافه کنید
// افزودن پیکان، مساحت، بیضی (بیضی)، حاشیه نویسی فاصله به PDF با پیام ها و پاسخ ها با استفاده از جاوا
final Annotator annotator = new Annotator(Constants.INPUT);
// تنظیم پاسخ ها
Reply reply1 = new Reply();
reply1.setComment("Please look in to these issues.");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Change Description");
reply2.setRepliedOn(Calendar.getInstance().getTime());

Reply reply3 = new Reply();
reply2.setComment("On-Premises APIs");
reply2.setRepliedOn(Calendar.getInstance().getTime());

Reply reply4 = new Reply();
reply2.setComment("Add images as well.");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List<Reply> replies = new ArrayList<Reply>();
replies.add(reply1);
replies.add(reply2);
replies.add(reply3);
replies.add(reply4);
// حاشیه نویسی پیکان =================================
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(560, 250, 60, -60));
arrow.setCreatedOn(Calendar.getInstance().getTime());
arrow.setMessage("This image is little upwards.");
arrow.setOpacity(0.7);
arrow.setPenColor(-3407872);
arrow.setPenWidth((byte) 2);
arrow.setReplies(replies.subList(0, 1));
// حاشیه نویسی ناحیه ===================================
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
area.setReplies(replies.subList(1, 2));
// حاشیه نویسی بیضی یا بیضی ========================
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("Shows all the available Annotation APIs.");
ellipse.setOpacity(0.7);
ellipse.setPenColor(-16034924);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies.subList(2, 3));
// حاشیه نویسی فاصله ===============================
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is the heading area");
distance.setOpacity(0.7);
distance.setPenColor(-21197);
distance.setPenStyle(PenStyle.Solid);
distance.setPenWidth((byte) 1);
distance.setReplies(replies.subList(3, 4));
// اضافه کردن حاشیه نویسی =================================
annotator.add(arrow);
annotator.add(area);
annotator.add(ellipse);
annotator.add(distance);
// ذخیره پی دی اف حاشیه نویسی ===============================
annotator.save(outputPath);
annotator.dispose();

حاشیه نویسی ها را از PDF در Java حذف کنید

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

سند PDF را با استفاده از کلاس Annotator بارگیری کنید.
با استفاده از کلاس SaveOptions ذخیره گزینه ها را راه اندازی کنید.
انواع حاشیه نویسی را روی None تنظیم کنید.
با ارائه مسیر با استفاده از روش save، فایل PDF را با حذف تمام حاشیه نویسی ها ذخیره کنید.

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

// تمام حاشیه نویسی ها را با استفاده از Java از سند PDF حذف کنید
final Annotator annotator = new Annotator("document.pdf");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
// PDF را بدون حاشیه نویسی در آن ذخیره کنید.
annotator.save("path/annotations-removed.pdf", saveOptions);
annotator.dispose();

نتیجه

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

برای جزئیات بیشتر، گزینه‌ها و مثال‌ها، می‌توانید از مستندات و مخزن GitHub دیدن کنید. برای سوالات بیشتر، با پشتیبانی در [فروم 36 تماس بگیرید.

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

اضافه کردن واترمارک به تصاویر در جاوا

PDF Annotator Java API#

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

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

با استفاده از جاوا، حاشیه نویسی پیکان را به PDF اضافه کنید#

با استفاده از جاوا، مستطیل یا حاشیه نویسی ناحیه را به PDF وارد کنید#

با استفاده از جاوا، حاشیه نویسی بیضی یا بیضی را به PDF اضافه کنید#

درج حاشیه نویسی فاصله به PDF با استفاده از Java#

کد کامل#

حاشیه نویسی ها را از PDF در Java حذف کنید#

نتیجه#

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