Tetapkan Properti Callout Dalam File PDF

Perkenalan

Membuat dokumen PDF yang profesional dan menarik secara visual sering kali memerlukan penambahan anotasi yang menarik perhatian ke konten tertentu. Salah satu anotasi tersebut adalah callout, yang seperti gelembung ucapan yang Anda lihat dalam komik. Anotasi tersebut membantu memperjelas atau menekankan teks dalam PDF Anda. Aspose.PDF untuk .NET memudahkan Anda untuk menambahkan anotasi tersebut ke dokumen Anda, dan dalam tutorial ini, kami akan memandu Anda tentang cara menyetel properti callout dalam file PDF menggunakan pustaka yang canggih ini. Baik Anda seorang pengembang berpengalaman atau baru memulai, di akhir panduan ini, Anda akan memiliki pemahaman yang jelas tentang cara bekerja dengan callout dalam file PDF.

Prasyarat

Sebelum kita masuk ke kode, mari kita bahas hal-hal penting yang Anda perlukan untuk memulai.

  1. Aspose.PDF untuk .NET: Pastikan Anda telah menginstal pustaka Aspose.PDF untuk .NET. Anda dapat mengunduhnya dariDi Sini.
  2. IDE: Lingkungan pengembangan seperti Visual Studio.
  3. .NET Framework: Pastikan Anda telah menginstal .NET di komputer Anda.
  4. Lisensi Sementara: Jika Anda ingin mencoba fitur lengkap Aspose.PDF tanpa batasan, dapatkan lisensi sementara.lisensi sementara.

Paket Impor

Sebelum Anda mulai menulis kode, Anda perlu mengimpor paket yang diperlukan yang memungkinkan Anda bekerja dengan file PDF dan anotasi.

using Aspose.Pdf.Annotations;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;

Impor ini akan memberi Anda semua kelas dan metode yang diperlukan untuk memanipulasi dokumen PDF dan membuat anotasi seperti keterangan.

Langkah 1: Inisialisasi Dokumen PDF

Langkah pertama dalam perjalanan kita adalah menginisialisasi dokumen PDF baru tempat kita akan menambahkan anotasi keterangan. Anggap saja ini seperti menyiapkan kanvas kosong tempat Anda dapat mulai menambahkan elemen.

// Jalur ke direktori dokumen.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Inisialisasi dokumen PDF baru
Document doc = new Document();

Di sini, kita membuat yang baruDocument objek yang akan berfungsi sebagai file PDF kita.dataDir variabel diatur ke direktori tempat Anda ingin menyimpan berkas PDF setelah selesai.

Langkah 2: Tambahkan Halaman Baru ke Dokumen

Dokumen PDF dapat memiliki beberapa halaman, dan pada langkah ini, kita akan menambahkan halaman baru ke dokumen kita. Halaman ini akan menjadi tempat anotasi keterangan kita.

//Tambahkan halaman baru ke dokumen
Page page = doc.Pages.Add();

ItuPages.Add()metode ini digunakan untuk menambahkan halaman baru kedoc objek. Halaman baru disimpan dipage variabel, yang akan kita gunakan nanti saat menambahkan anotasi.

Langkah 3: Tentukan Tampilan Default

Anotasi, seperti keterangan, memiliki tampilan visual yang dapat Anda sesuaikan. Pada langkah ini, kita akan menentukan bagaimana teks dalam keterangan akan terlihat.

// Tentukan tampilan default untuk anotasi
DefaultAppearance da = new DefaultAppearance();
da.TextColor = System.Drawing.Color.Red;
da.FontSize = 10;

Kami menciptakan sebuahDefaultAppearance objek yang menentukan warna teks dan ukuran fon. Di sini, teks akan berwarna merah, dan ukuran fon ditetapkan ke 10. Tampilan ini akan diterapkan pada anotasi keterangan.

Langkah 4: Buat Anotasi Teks Bebas

Sekarang saatnya membuat anotasi yang sebenarnya. Anotasi teks bebas memungkinkan kita menambahkan keterangan dengan teks dan gaya tertentu.

// Buat FreeTextAnnotation dengan callout
FreeTextAnnotation fta = new FreeTextAnnotation(page, new Rectangle(422.25, 645.75, 583.5, 702.75), da);
fta.Intent = FreeTextIntent.FreeTextCallout;
fta.EndingStyle = LineEnding.OpenArrow;

Kami menciptakan sebuahFreeTextAnnotation objek dengan koordinat tertentu, yang menentukan posisinya di halaman.Intent diatur untukFreeTextCallout , yang menunjukkan bahwa ini adalah anotasi panggilan.EndingStyle diatur untukOpenArrowyang berarti baris keterangan akan diakhiri dengan panah terbuka.

Langkah 5: Tentukan Titik Garis Panggilan

Anotasi keterangan memiliki garis yang menunjuk ke area yang diinginkan. Di sini, kita akan menentukan titik-titik yang membentuk garis ini.

// Tentukan titik untuk garis panggilan
fta.Callout = new Point[]
{
    new Point(428.25, 651.75), 
    new Point(462.75, 681.375), 
    new Point(474, 681.375)
};

ItuCallout properti adalah sebuah arrayPoint objek, yang masing-masing mewakili koordinat pada halaman. Titik-titik ini menentukan jalur baris keterangan, sehingga memberikan tampilan gelembung ucapan klasik.

Langkah 6: Tambahkan Anotasi ke Halaman

Setelah membuat dan mengonfigurasi anotasi, langkah berikutnya adalah menambahkannya ke halaman.

// Tambahkan anotasi ke halaman
page.Annotations.Add(fta);

ItuAnnotations.Add() Metode ini digunakan untuk menempatkan anotasi pada halaman yang kita buat sebelumnya. Langkah ini secara efektif “menggambar” keterangan pada halaman PDF.

Langkah 7: Mengatur Konten Teks Kaya

Anotasi keterangan dapat menyertakan teks kaya, yang memungkinkan konten yang diformat dalam gelembung. Mari tambahkan beberapa contoh teks.

// Tetapkan teks kaya untuk anotasi
fta.RichText = "<body xmlns=\"http://www.w3.org/1999/xhtml\" xmlns:xfa=\"http://www.xfa.org/schema/xfa-data/1.0/\" xfa:APIVersion=\"Acrobat:11.0.23\" xfa:spec=\"2.0.2\" style=\"color:#FF0000;font-weight:normal;font-style:normal;font-stretch:normal\"><p dir=\"ltr\"><span style=\"font-size:9.0pt;font-family:Helvetica\">Ini adalah contoh</span></p></body>";

ItuRichText properti diatur dengan konten HTML. Hal ini memungkinkan pemformatan terperinci dalam keterangan, seperti menentukan ukuran font, warna, dan gaya.

Langkah 8: Simpan Dokumen PDF

Terakhir, setelah menyiapkan semuanya, kita perlu menyimpan dokumen. Langkah ini menyelesaikan pembuatan PDF dengan anotasi callout.

// Simpan dokumen
doc.Save(dataDir + "SetCalloutProperty.pdf");

ItuSave() metode menyimpan dokumen ke direktori yang ditentukan dengan nama file “SetCalloutProperty.pdf”. Langkah ini mengakhiri proses pembuatan PDF kita.

Kesimpulan

Nah, itu dia! Anda baru saja membuat dokumen PDF dengan anotasi callout menggunakan Aspose.PDF untuk .NET. Anotasi ini dapat sangat berguna untuk menyorot atau menjelaskan bagian tertentu dari dokumen Anda. Aspose.PDF menawarkan API canggih yang membuat manipulasi PDF menjadi mudah dan fleksibel. Baik Anda menambahkan anotasi, mengonversi dokumen, atau menangani tugas PDF yang rumit, Aspose.PDF siap membantu Anda.

Pertanyaan yang Sering Diajukan

Bisakah saya menyesuaikan tampilan keterangan lebih lanjut?

Tentu saja! Anda dapat menyesuaikan berbagai aspek seperti warna garis, ketebalan, serta jenis dan gaya font teks.

Bisakah saya menambahkan beberapa keterangan pada satu halaman?

Ya, Anda dapat menambahkan keterangan sebanyak-banyaknya sesuai kebutuhan dengan mengulangi langkah-langkah untuk setiap anotasi.

Bagaimana cara mengubah posisi keterangan?

Cukup ubah koordinat diRectangle DanCallout properti untuk memposisikan ulang anotasi.

Bisakah saya menambahkan jenis anotasi lain menggunakan Aspose.PDF?

Ya, Aspose.PDF mendukung berbagai jenis anotasi, termasuk sorotan, stempel, dan lampiran file.

Apakah konten teks kaya terbatas pada HTML?

ItuRichText Properti mendukung sebagian kecil HTML, yang memungkinkan Anda menyertakan teks bergaya dan format dasar.

Redaksi Halaman Atur Format Anotasi Teks Bebas