איך להוסיף צורות שרטוט למסמכי Word ב-.NET

שלב 1: קבל את הספרייה

שכפל את המאגרים ובנה Aspose.Words.sln בהגדרת Release, ולאחר מכן הוסף הפנייה לפרויקט ל Aspose.Words.csproj מפרויקט .NET שלך, כפי שמתואר ב- מדריך ההתקנה. הוסף using Aspose.Words; and using Aspose.Words.Drawing; בראש כל קובץ שעובד עם צורות.

שלב 2: הוסף AutoShape

בנה צורה ישירות עם new Shape(doc, shapeType), כאשר shapeType הוא ערך ShapeType כגון Rectangle, Ellipse, Star או TextBox, ולאחר מכן הוסף אותה לעץ באמצעות DocumentBuilder.InsertNode(node). Shape היא המחלקה הקונקרטית והסגורה שאתה בונה ומגדיר; היא יורשת מהמחלקה המופשטת ShapeBase, שמגדירה מיקום (Left, Top, Width, Height, Rotation) ותת-אובייקטים של עיצוב (Fill, Stroke, ShadowFormat, Glow, Reflection) משותפים עם GroupShape.

שלב 3: הוסף תמונה

DocumentBuilder.InsertImage הוא הנתיב הישיר לתמונות: עומסי יתר מקבלים Image, נתיב קובץ, Stream, או מערך בתים גולמי, עם עומסי יתר נוספים שמקבלים width/height מפורשים או ארגומנטים של מיקום מלא (horzPos, left, vertPos, top, width, height, wrapType). ה-ImageData של Shape מחזיק את נתוני התמונה — קרא ל-ImageData.SetImage(...) כדי להחליף את התמונה, והשתמש ב-CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast, ו-GrayScale להתאמות בסיסיות.

שלב 4: מיקום הצורה והקפת טקסט

צורה משולבת (התוצאה ברירת המחדל של InsertImage) זורמת עם הטקסט הסובב ומתעלמת מתכונות המיקום עד שהיא צפה — בדוק את IsInline כדי לאשר באיזה מצב נמצאת הצורה. כדי לצוף צורה, הגדר את WrapType לערך שאינו משולב והגדר את RelativeHorizontalPosition / RelativeVerticalPosition (כל אחד יחסית ל-Page, Margin, Column, או עוגן דומה) יחד עם ההזזות Left/Top. WrapSide שולט בהקפת טקסט ספציפית לצד, ו-HorizontalAlignment / VerticalAlignment מטפלים ביישור יחסי פשוט במקום הזזות מפורשות.

שלב 5: מילוי ועיצוב הצורה

Shape.Fill (אובייקט Fill) מצייר את פנימיות הצורה: Fill.Solid(color) לצבע אחיד, Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) למעברים, Fill.Patterned(patternType) לתבנית, ו-Fill.SetImage(...) למילוי בתמונה — FillType מדווח איזו אפשרות פעילה כעת. הקו החיצוני נובע מהמאפיין Stroke. עבור אפקטים, ShadowFormat, Glow (GlowFormat), Reflection (ReflectionFormat) ו-SoftEdge (SoftEdgeFormat) כל אחד חושף את ההגדרות שלו ו-Remove() שמוחק את האפקט חזרה ללא דבר.

שלב 6: קיבוץ מספר צורות

קבץ מספר צורות ליחידה אחת באמצעות DocumentBuilder.InsertGroupShape(shapes), שמחזירה GroupShape. GroupShape הוא בעצמו ShapeBase, ולכן הוא נושא את ה-Fill, ShadowFormat, Glow, ו-Reflection שלו החלים על הקבוצה כולה; הזז או שנה את גודלה של GroupShape במקום הילדים היחידים שלה כדי שהטרנספורמציה של הקואורדינטות של הקבוצה תישאר עקבית. עבור צורה שנושאת טקסט, Shape.TextBox (אובייקט TextBox) שולט במרווחים (InternalMarginLeft/Right/Top/Bottom), שינוי גודל אוטומטי (FitShapeToText), כיוון הטקסט (LayoutFlow), ויישור אנכי (VerticalAnchor).

שלב 7: הוסף סימן מים

Document.Watermark מנהל סימן מים יחיד לכל המסמך, ללא תלות בכל צורה שהוספת ידנית. קרא ל-Watermark.SetText(text) או ל-SetText(text, options) כדי לקבל סימן מים טקסטואלי, או ל-SetImage(...) לסימן מים תמונה; Watermark.Remove() מוחק אותו, ו-Watermark.Type מדווח על ה-WatermarkType הנוכחי (Text, Image או None). TextWatermarkOptions מגדיר את FontFamily, FontSize, Color, ו-Layout (WatermarkLayout.Horizontal או Diagonal); ImageWatermarkOptions מגדיר את Scale ו-IsWashout.