עבודה עם סימני מים
עבודה עם סימני מים
מדריך זה מציג כיצד להוסיף, להגדיר ולהסיר סימני מים של מסמכים ב Aspose.Words FOSS עבור .NET באמצעות Watermark מחלקה, שהושגה דרך Document.Watermark. סימן מים יכול להיות טקסט או תמונה, ורק סימן מים אחד פעיל במסמך בכל זמן — הגדרת חדש מחליפה את מה שהיה שם קודם.
הוספת סימן מים טקסטואלי
Watermark.SetText(text) מוסיף סימן מים טקסטואלי עם עיצוב ברירת מחדל. העומס SetText(text, options) מקבל מופע של TextWatermarkOptions כדי לשלוט במראה שלו: FontFamily, Color ו-FontSize שולטות בעיצוב הטקסט, IsSemitrasparent משנה את אפקט השקיפות החצי-שקופה האופייני לסימני מים, ו-Layout (ערך WatermarkLayout – Horizontal או Diagonal) שולט בכיוונו ביחס לעמוד.
הוספת סימן מים תמונה
Watermark.SetImage(image) מוסיף סימן מים תמונה מ-Image שכבר נטען. עומסים שגם מקבלים מופע של ImageWatermarkOptions – SetImage(image, options), SetImage(imagePath, options) (טעינה מנתיב קובץ), ו-SetImage(imageStream, options) (טעינה מ-Stream) – מאפשרים לך לשלוט ב-Scale (מקדם קנה המידה של התמונה, מבוטא כשבר) וב-IsWashout (אפקט ההלבנה שמונע מתמונת סימן המים לגבור על תוכן העמוד).
בדיקה והסרת סימן מים
Watermark.Type מדווח על סוג סימן המים הנוכחי כערך WatermarkType — Text, Image או None אם לא הוגדר סימן מים. קרא Watermark.Remove() כדי להסיר את סימן המים הנוכחי מהמסמך.
טיפים ושיטות מומלצות
- בדוק את
Watermark.Typeלפני שאתה מניח שסימן מים קיים — הוא מחזירWatermarkType.Noneבמסמך שמעולם לא הוגדר בו סימן מים. - הגדרת סימן מים חדש באמצעות
SetText()אוSetImage()מחליפה כל סימן מים קיים; אין אפשרות שיהיו יותר מסימן מים פעיל אחד בו-זמן. - השתמש ב-
WatermarkLayout.Diagonalכדי לשחזר את כיוון סימן המים האלכסוני ברירת המחדל של Word, או ב-Horizontalלסימן מים הרץ במקביל לקצוות העמוד. - העדף את העומס של
ImageWatermarkOptions/TextWatermarkOptionsעל פני הקריאות הפשוטות שלSetImage(image)/SetText(text)כאשר אתה צריך לשלוט בשקיפות, קנה מידה או גופן — העומסים ללא פרמטרים משתמשים בברירות המחדל של Word.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
| סימן המים החדש אינו מופיע לצד הישן | SetText()/SetImage() מחליף את סימן המים הקיים במקום להוסיף סימן שני | קרא ל-Remove() תחילה רק אם אתה צריך לנקות אותו לפני הגדרת סוג שונה; אחרת ההחלפה מתבצעת אוטומטית |
| סימן מים בתמונה מציף את תוכן העמוד | ImageWatermarkOptions.IsWashout נותר מושבת | הגדר את IsWashout ל-true כאשר אתה בונה את ImageWatermarkOptions |
| גופן של סימן המים הטקסטואלי אינו תואם לגופן הרצוי | TextWatermarkOptions.FontFamily לא הוגדר (או שהוקלד בטעות) | הגדר את FontFamily לשם גופן זמין בסביבת הרינדור |
FAQ
איך אני בודק אם למסמך כבר יש סימן מים?
קרא Document.Watermark.Type; הוא מחזיר WatermarkType.Text, WatermarkType.Image או WatermarkType.None.
איך להסיר סימן מים?
קרא Document.Watermark.Remove().
האם אני יכול לשלוט בשקיפות של סימן המים?
כן – עבור סימני מים טקסטיים, הגדר TextWatermarkOptions.IsSemitrasparent; עבור סימני מים תמונתיים, הגדר ImageWatermarkOptions.IsWashout.
איך אני טוען סימן מים תמונה מהדיסק במקום Image בזיכרון?
השתמש בגרסת העומס Watermark.SetImage(imagePath, options), העבר את נתיב הקובץ כמחרוזת יחד עם מופע של ImageWatermarkOptions.
API Reference תקציר
| מחלקה / Enum | תיאור |
|---|---|
Watermark | חותמת מסמך, דרך Document.Watermark; SetText(), SetImage(), Remove(), Type |
WatermarkType | Enum שמזהה את סוג חותמת המים הנוכחי: Text, Image, None |
WatermarkLayout | Enum לכיוון חותמת המים: Horizontal, Diagonal |
TextWatermarkOptions | עיצוב סימן מים בטקסט: FontFamily, Color, FontSize, IsSemitrasparent, Layout |
ImageWatermarkOptions | אפשרויות סימן מים בתמונה: Scale, IsWashout |
