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

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

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

برای افزودن یا حذف حاشیه‌نویسی‌های PDF، از Aspose.PDF برای جاوا استفاده می‌کنیم. این یک API غنی از ویژگی ها است که به شما امکان می دهد فایل های PDF را با استفاده از جاوا تولید، ویرایش و تبدیل کنید. علاوه بر این، API به شما اجازه می دهد تا با طیف گسترده ای از حاشیه نویسی های PDF به طور یکپارچه کار کنید. می‌توانید API را دانلود یا با استفاده از تنظیمات Maven زیر نصب کنید.

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-pdf</artifactId>
    <version>21.3</version>
</dependency>

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

Aspose.PDF برای جاوا از تعدادی حاشیه نویسی از جمله متن، خط، دایره، مربع، برجسته و غیره پشتیبانی می کند. به عنوان مثال، کلاس LineAnnotation برای افزودن یک خط استفاده می شود، در حالی که کلاس HighlightAnnotation برای افزودن حاشیه نویسی برجسته استفاده می شود.

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

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

  • ابتدا سند PDF را با استفاده از کلاس Document بارگذاری کنید.
  • یک شی از کلاس TextAnnotation برای اضافه کردن حاشیه نویسی متن ایجاد کنید.
  • ویژگی های حاشیه نویسی مانند عنوان، موضوع و غیره را تنظیم کنید.
  • حاشیه حاشیه نویسی را با استفاده از کلاس Border تنظیم کنید.
  • با استفاده از روش Document.getPages().getItem(int).getAnnotations().add(Annotation) حاشیه نویسی را به سند اضافه کنید.
  • در نهایت، PDF به روز شده را با استفاده از روش Document.save(string) ذخیره کنید.

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

// سند PDF منبع را باز کنید
Document pdfDocument = new Document("input.pdf");

// حاشیه نویسی ایجاد کنید
TextAnnotation textAnnotation = new TextAnnotation(pdfDocument.getPages().get_Item(1), new com.aspose.pdf.Rectangle(200, 400, 400, 600));

// عنوان حاشیه نویسی را تنظیم کنید
textAnnotation.setTitle("Sample Annotation Title");

// تنظیم موضوع حاشیه نویسی
textAnnotation.setSubject("Sample Subject");
textAnnotation.setState(AnnotationState.Accepted);

// محتویات حاشیه نویسی را مشخص کنید
textAnnotation.setContents("Sample contents for the annotation");
textAnnotation.setOpen(true);
textAnnotation.setIcon(TextIcon.Key);
Border border = new Border(textAnnotation);
border.setWidth(5);
border.setDash(new Dash(1, 1));
textAnnotation.setBorder(border);
textAnnotation.setRect(new com.aspose.pdf.Rectangle(200, 400, 400, 600));

// حاشیه نویسی را در مجموعه حاشیه نویسی صفحه اضافه کنید
pdfDocument.getPages().get_Item(1).getAnnotations().add(textAnnotation);

// فایل خروجی را ذخیره کنید
pdfDocument.save("output.pdf");

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

برای حذف حاشیه نویسی ها از یک صفحه در PDF، Aspose.PDF برای جاوا گزینه های زیر را ارائه می دهد:

  • یک حاشیه نویسی خاص را در یک صفحه حذف کنید
  • تمام حاشیه نویسی های یک صفحه را حذف کنید

یک حاشیه نویسی PDF خاص را حذف کنید

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

نمونه کد زیر نحوه حذف یک حاشیه نویسی خاص از یک صفحه در PDF را با استفاده از جاوا نشان می دهد.

// سند PDF منبع را باز کنید
Document pdfDocument = new Document("input.pdf");

// حاشیه نویسی خاص را حذف کنید
pdfDocument.getPages().get_Item(1).getAnnotations().delete(1);

// سند به روز رسانی را ذخیره کنید
pdfDocument.save("output.pdf");

تمام حاشیه نویسی های PDF را حذف کنید

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

نمونه کد زیر نحوه حذف تمام حاشیه نویسی های یک صفحه در PDF را با استفاده از جاوا نشان می دهد.

// سند PDF منبع باز
Document pdfDocument = new Document("input.pdf");

// تمام حاشیه نویسی را حذف کنید
pdfDocument.getPages().get_Item(1).getAnnotations().delete();

// سند به روز رسانی را ذخیره کنید
pdfDocument.save("output.pdf");

یک مجوز API رایگان دریافت کنید

می توانید Aspose.PDF را برای جاوا به صورت رایگان و بدون محدودیت ارزیابی با استفاده از [مجوز موقت] امتحان کنید.

نتیجه

در این مقاله نحوه کار با حاشیه نویسی در فایل های PDF را یاد گرفتید. به ویژه، نحوه افزودن یا حذف حاشیه نویسی در فایل های PDF با استفاده از جاوا را دیده اید. می‌توانید با استفاده از مستندات درباره Aspose.PDF برای جاوا بیشتر کاوش کنید. در صورت داشتن هرگونه سوال یا سؤال، لطفاً از طریق [تالار گفتمان20 ما را در جریان بگذارید.

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