Bekerja dengan Watermarks

Bekerja dengan Watermark

Panduan ini menunjukkan cara menambahkan, mengonfigurasi, dan menghapus watermark dokumen di Aspose.Words FOSS for .NET menggunakan Watermark kelas, diakses melalui Document.Watermark. Watermark dapat berupa teks atau gambar, dan hanya satu watermark yang aktif pada sebuah dokumen pada satu waktu – menetapkan yang baru akan menggantikan apa pun yang sebelumnya ada.

Menambahkan Watermark Teks

Watermark.SetText(text) menambahkan watermark teks dengan format default. Overload SetText(text, options) menerima sebuah instance TextWatermarkOptions untuk mengontrol penampilannya: FontFamily, Color, dan FontSize mengontrol format teks, IsSemitrasparent mengaktifkan efek semi-transparan khas watermark, dan Layout (sebuah nilai WatermarkLayout – Horizontal atau Diagonal) mengontrol orientasinya relatif terhadap halaman.

Menambahkan Watermark Gambar

Watermark.SetImage(image) menambahkan watermark gambar dari Image yang sudah dimuat. Overload yang juga menerima sebuah instance ImageWatermarkOptions – SetImage(image, options), SetImage(imagePath, options) (memuat dari jalur file), dan SetImage(imageStream, options) (memuat dari Stream) – memungkinkan Anda mengontrol Scale (faktor skala gambar, dinyatakan sebagai pecahan) dan IsWashout (efek pudar yang mencegah gambar watermark menguasai konten halaman).

Memeriksa dan Menghapus Watermark

Watermark.Type melaporkan jenis watermark saat ini sebagai nilai WatermarkType – Text, Image, atau None jika tidak ada watermark yang disetel. Panggil Watermark.Remove() untuk menghapus watermark saat ini dari dokumen.

Tips dan Praktik Terbaik

Periksa Watermark.Type sebelum mengasumsikan ada watermark – ia mengembalikan WatermarkType.None pada dokumen yang belum pernah memiliki watermark yang disetel.
Menetapkan watermark baru melalui SetText() atau SetImage() menggantikan semua watermark yang ada; tidak ada cara untuk memiliki lebih dari satu watermark aktif sekaligus.
Gunakan WatermarkLayout.Diagonal untuk mereproduksi orientasi watermark diagonal default Word, atau Horizontal untuk watermark yang berjalan paralel dengan tepi halaman.
Lebih pilih overload ImageWatermarkOptions/TextWatermarkOptions daripada pemanggilan SetImage(image) / SetText(text) biasa setiap kali Anda perlu mengontrol opacity, skala, atau font – overload tanpa parameter menggunakan default Word.

Masalah Umum

Masalah	Penyebab	Perbaikan
Watermark baru tidak muncul bersamaan dengan yang lama	`SetText()`/`SetImage()` menggantikan watermark yang ada daripada menambahkan yang kedua	Panggil `Remove()` terlebih dahulu hanya jika Anda perlu menghapusnya sebelum mengatur jenis yang berbeda; jika tidak, penggantiannya otomatis
Watermark gambar membanjiri konten halaman	`ImageWatermarkOptions.IsWashout` dibiarkan dinonaktifkan	Atur `IsWashout` ke `true` saat membangun `ImageWatermarkOptions`
Font watermark teks tidak cocok dengan jenis huruf yang dimaksud	`TextWatermarkOptions.FontFamily` tidak disetel (atau salah eja)	Set `FontFamily` ke nama font yang tersedia di lingkungan rendering

FAQ

Bagaimana cara saya memeriksa apakah dokumen sudah memiliki watermark?

Baca Document.Watermark.Type; ia mengembalikan WatermarkType.Text, WatermarkType.Image, atau WatermarkType.None.

Bagaimana cara menghapus watermark?

Panggil Document.Watermark.Remove().

Bisakah saya mengontrol transparansi watermark?

Ya – untuk watermark teks, set TextWatermarkOptions.IsSemitrasparent; untuk watermark gambar, set ImageWatermarkOptions.IsWashout.

Bagaimana cara memuat watermark gambar dari disk alih-alih `Image` dalam memori?

Gunakan overload Watermark.SetImage(imagePath, options), dengan melewatkan jalur file sebagai string bersama dengan instance ImageWatermarkOptions.

API Reference Ringkasan

Kelas / Enum	Deskripsi
`Watermark`	Watermark dokumen, via `Document.Watermark`; `SetText()`, `SetImage()`, `Remove()`, `Type`
`WatermarkType`	Enum yang mengidentifikasi jenis watermark saat ini: `Text`, `Image`, `None`
`WatermarkLayout`	Enum untuk orientasi watermark: `Horizontal`, `Diagonal`
`TextWatermarkOptions`	Pemformatan watermark teks: `FontFamily`, `Color`, `FontSize`, `IsSemitrasparent`, `Layout`
`ImageWatermarkOptions`	Opsi watermark gambar: `Scale`, `IsWashout`

Lihat Juga

Aspose.Words for .NET — Enterprise Documentation

Bekerja dengan Watermarks