В этой главе мы увидим, как добавить аннотацию ссылки в документ PDF с помощью библиотеки iText.
Создание аннотации ссылки в PDF
Вы можете создать пустой PDF-документ, создав экземпляр класса Document . При создании экземпляра этого класса вам необходимо передать объект PdfDocument в качестве параметра его конструктору.
Чтобы использовать текстовую аннотацию в вашем PDF-документе, вам нужно создать объект класса PdfTextAnnotation и добавить его в PdfPage.
Ниже приведены инструкции по использованию текстовой аннотации в документе PDF.
Шаг 1: Создание объекта PdfWriter
Класс PdfWriter представляет DocWriter для PDF. Этот класс принадлежит пакету com.itextpdf.kernel.pdf . Конструктор этого класса принимает строку, представляющую путь к файлу, в котором должен быть создан PDF.
Создайте экземпляр класса PdfWriter , передав строковое значение (представляющее путь, по которому вам нужно создать PDF), в его конструктор, как показано ниже.
// Creating a PdfWriter String dest = "C:/itextExamples/linkAnnotation.pdf"; PdfWriter writer = new PdfWriter(dest);
Когда объект этого типа передается в PdfDocument (класс), каждый элемент, добавленный в этот документ, будет записан в указанный файл.
Шаг 2: Создание объекта PdfDocument
Класс PdfDocument — это класс, который представляет документ PDF в iText. Этот класс принадлежит пакету com.itextpdf.kernel.pdf . Чтобы создать экземпляр этого класса (в режиме записи), вам нужно передать объект класса PdfWriter его конструктору.
Создайте экземпляр класса PdfDocument, передав объект PdfWriter его конструктору, как показано ниже.
// Creating a PdfDocument PdfDocument pdfDoc = new PdfDocument(writer);
После создания объекта PdfDocument вы можете добавить различные элементы, такие как страница, шрифт, вложение файла и обработчик события, используя соответствующие методы, предоставляемые его классом.
Шаг 3: Создание объекта Document
Класс Document пакета com.itextpdf.layout является корневым элементом при создании самодостаточного PDF. Один из конструкторов этого класса принимает объект класса PdfDocument .
Создайте экземпляр класса Document , передав объект класса PdfDocument, созданный на предыдущих шагах, как показано ниже.
// Creating a Document Document document = new Document(pdfDoc);
Шаг 4: Создание объекта PdfAnnotation
Класс PdfAnnotation пакета com.itextpdf.kernel.pdf.annot представляет суперкласс всех аннотаций.
Среди его производных классов класс PdfLinkAnnotation представляет аннотацию ссылки. Создайте объект этого класса, как показано ниже.
// Creating a PdfLinkAnnotation object Rectangle rect = new Rectangle(0, 0); PdfLinkAnnotation annotation = new PdfLinkAnnotation(rect);
Шаг 5: Настройка действия аннотации
Установите действие для аннотации, используя метод setAction () класса PdfLinkAnnotation , как показано ниже.
// Setting action of the annotation PdfAction action = PdfAction.createURI("http: // www.tutorialspoint.com/"); annotation.setAction(action);
Шаг 6: Создание ссылки
Создайте ссылку, создав экземпляр класса Link пакета com.itextpdf.layout.element , как показано ниже.
// Creating a link Link link = new Link("Click here", annotation);
Шаг 7: Добавление аннотации ссылки к абзацу
Создайте новый абзац, создав экземпляр класса Paragraph и добавьте ссылку, созданную на предыдущем шаге, с помощью метода add () этого класса, как показано ниже.
// Creating a paragraph Paragraph paragraph = new Paragraph("Hi welcome to Tutorialspoint "); // Adding link to paragraph paragraph.add(link.setUnderline());
Шаг 8: Добавление абзаца в документ
Добавьте абзац в документ, используя метод add () класса Document , как показано ниже.
// Adding paragraph to document document.add(paragraph);
Шаг 9: Закрытие документа
Закройте документ с помощью метода close () класса Document , как показано ниже.
// Closing the document document.close();
пример
Следующая программа на Java демонстрирует, как добавить аннотацию ссылки в документ PDF с помощью библиотеки iText.
Он создает документ PDF с именем linkAnnotation.pdf , добавляет к нему аннотацию ссылки и сохраняет ее по пути C: / itextExamples /
Сохраните этот код в файле с именем LinkAnnotation.java .
import com.itextpdf.kernel.geom.Rectangle; import com.itextpdf.kernel.pdf.PdfDocument; import com.itextpdf.kernel.pdf.PdfWriter; import com.itextpdf.kernel.pdf.action.PdfAction; import com.itextpdf.kernel.pdf.annot.PdfLinkAnnotation; import com.itextpdf.layout.Document; import com.itextpdf.layout.element.Link; import com.itextpdf.layout.element.Paragraph; public class LinkAnnotation { public static void main(String args[]) throws Exception { // Creating a PdfWriter String dest = "C:/itextExamples/linkAnnotation.pdf"; PdfWriter writer = new PdfWriter(dest); // Creating a PdfDocument PdfDocument pdf = new PdfDocument(writer); // Creating a Document Document document = new Document(pdf); // Creating a PdfLinkAnnotation object Rectangle rect = new Rectangle(0, 0); PdfLinkAnnotation annotation = new PdfLinkAnnotation(rect); // Setting action of the annotation PdfAction action = PdfAction.createURI("http:// www.tutorialspoint.com/"); annotation.setAction(action); // Creating a link Link link = new Link("Click here", annotation); // Creating a paragraph Paragraph paragraph = new Paragraph("Hi welcome to Tutorialspoint "); // Adding link to paragraph paragraph.add(link.setUnderline()); // Adding paragraph to document document.add(paragraph); // Closing the document document.close(); System.out.println("Annotation added successfully"); } }
Скомпилируйте и выполните сохраненный файл Java из командной строки, используя следующие команды:
javac LinkAnnotation.java java LinkAnnotation
После выполнения вышеуказанная программа создает документ PDF, отображающий следующее сообщение.
Annotation added successfully
Если вы проверите указанный путь, вы можете найти созданный PDF-документ, как показано ниже.