Filigranlarla Çalışma
Filigranlarla Çalışma
Bu kılavuz, belge filigranlarını ekleme, yapılandırma ve kaldırma işlemlerinin nasıl yapılacağını gösterir Aspose.Words FOSS için .NET kullanarak Watermark sınıf, şuradan erişilen Document.Watermark. Bir filigran metin veya resim olabilir ve bir belgede aynı anda yalnızca bir filigran aktiftir – yeni bir filigran ayarlamak, önceden oradaki şeyi değiştirir.
Metin Filigranı Ekleme
Watermark.SetText(text), varsayılan biçimlendirme ile bir metin filigranı ekler. SetText(text, options) aşırı yüklemesi, görünümünü kontrol etmek için bir TextWatermarkOptions örneği alır: FontFamily, Color ve FontSize metin biçimlendirmesini denetler, IsSemitrasparent filigranlarda tipik olan yarı şeffaf efekti açıp kapatır ve Layout (bir WatermarkLayout değeri — Horizontal veya Diagonal) sayfaya göre yönelimini kontrol eder.
Görüntü Filigranı Ekleme
Watermark.SetImage(image), önceden yüklenmiş bir Image üzerinden bir görüntü filigranı ekler. Ayrıca bir ImageWatermarkOptions örneği alan aşırı yüklemeler — SetImage(image, options), SetImage(imagePath, options) (dosya yolundan yükleme) ve SetImage(imageStream, options) (Stream üzerinden yükleme) — Scale (görüntünün ölçek faktörü, kesir olarak ifade edilir) ve IsWashout (filigran görüntüsünün sayfa içeriğini bastırmasını önleyen soluklaştırılmış etki) kontrol etmenizi sağlar.
Filigranı Kontrol Etme ve Kaldırma
Watermark.Type mevcut filigranın türünü bir WatermarkType değeri olarak rapor eder – Text, Image veya None eğer filigran ayarlanmamışsa. Watermark.Remove() çağırarak mevcut filigranı belgeden kaldırın.
İpuçları ve En İyi Uygulamalar
- Bir filigranın var olduğunu varsaymadan önce
Watermark.Typekontrol edin – hiç filigran ayarlanmamış bir belgedeWatermarkType.Nonedöndürür. SetText()veyaSetImage()aracılığıyla yeni bir filigran ayarlamak, mevcut tüm filigranları değiştirir; aynı anda birden fazla aktif filigran olması mümkün değildir.- Word’ün varsayılan diyagonal filigran yönelimini yeniden oluşturmak için
WatermarkLayout.Diagonalkullanın, ya da sayfa kenarlarına paralel bir filigran içinHorizontalkullanın. - Saydamlık, ölçek veya yazı tipi kontrolüne ihtiyaç duyduğunuzda düz
SetImage(image)/SetText(text)çağrıları yerineImageWatermarkOptions/TextWatermarkOptionsaşırı yüklemelerini tercih edin – parametresiz aşırı yüklemeler Word’ün varsayılanlarını kullanır.
Yaygın Sorunlar
| Sorun | Sebep | Düzeltme |
|---|---|---|
| Yeni bir filigran eskiyle birlikte görünmüyor | SetText()/SetImage() mevcut filigranı ikinci bir filigran eklemek yerine değiştirir | Farklı bir tür ayarlamadan önce temizlemeniz gerekiyorsa önce Remove() çağırın; aksi takdirde değiştirme otomatik olarak gerçekleşir |
| Görsel filigran sayfa içeriğini bastırıyor | ImageWatermarkOptions.IsWashout devre dışı bırakılmış olarak bırakıldı | ImageWatermarkOptions oluşturulurken IsWashout değerini true olarak ayarlayın |
| Metin filigranının yazı tipi istenen tipografiyle eşleşmiyor | TextWatermarkOptions.FontFamily ayarlanmamış (ya da yanlış yazılmış) | Render ortamında mevcut bir yazı tipi adı olarak FontFamily‘ı ayarlayın |
FAQ
Bir belgenin zaten bir filigran içerip içermediğini nasıl kontrol ederim?
Read Document.Watermark.Type; WatermarkType.Text, WatermarkType.Image veya WatermarkType.None döndürür.
Filigranı nasıl kaldırırım?
Document.Watermark.Remove() çağırın.
Filigranın şeffaflığını kontrol edebilir miyim?
Evet – metin filigranları için TextWatermarkOptions.IsSemitrasparent ayarlayın; görüntü filigranları için ImageWatermarkOptions.IsWashout ayarlayın.
Bellekteki Image yerine diskten bir görüntü filigranı nasıl yüklerim?
Watermark.SetImage(imagePath, options) aşırı yüklemesini kullanın, dosya yolunu bir dize olarak ve bir ImageWatermarkOptions örneğiyle geçirin.
API Reference Özeti
| Sınıf / Enum | Açıklama |
|---|---|
Watermark | Belge filigranı, Document.Watermark aracılığıyla; SetText(), SetImage(), Remove(), Type |
WatermarkType | Mevcut filigran türünü belirten Enum: Text, Image, None |
WatermarkLayout | Filigran yönelimi için Enum: Horizontal, Diagonal |
TextWatermarkOptions | Metin filigranı biçimlendirmesi: FontFamily, Color, FontSize, IsSemitrasparent, Layout |
ImageWatermarkOptions | Görüntü filigranı seçenekleri: Scale, IsWashout |