עבודה עם צורות

נושא זה דן כיצד לעבוד באופן פרוגרמטי עם צורות באמצעות Aspose.Words.

הצורות ב Aspose.Words מייצגות אובייקט בשכבת הציור, כגון AutoShape, תיבת טקסט, צורה חופשית, OLE אובייקט, בקרת אקטיבקס או תמונה. מסמך Word יכול להכיל צורה אחת או יותר. צורות המסמך מיוצגות על ידי הכיתה Shape.

הכנס צורה באמצעות בונה מסמכים

ניתן להוסיף צורה מוטבעת עם סוג וגודל מוגדרים וצורה צפה חופשית עם המיקום, הגודל וסוג גלישת הטקסט שצוינו למסמך בשיטת InsertShape. שיטת InsertShape מאפשרת הכנסת DML צורה למודל המסמך. יש לשמור את המסמך בפורמט, התומך בצורות DML, אחרת, צמתים כאלה יומרו לצורה VML, תוך שמירת מסמך.

דוגמת הקוד הבאה מראה כיצד להכניס צורות מסוג זה למסמך:

הגדר יחס גובה-רוחב נעול

באמצעות Aspose.Words, אתה יכול לציין אם יחס הגובה-רוחב של הצורה נעול דרך המאפיין AspectRatioLocked.

דוגמת הקוד הבאה מראה כיצד לעבוד עם המאפיין AspectRatioLocked:

הגדר פריסת צורה בתא

ניתן גם לציין אם הצורה מוצגת בתוך טבלה או מחוצה לה באמצעות המאפיין IsLayoutInCell.

דוגמת הקוד הבאה מראה כיצד לעבוד עם המאפיין IsLayoutInCell:

צור מלבן פינת חיתוך

ניתן ליצור מלבן פינתי חיתוך באמצעות Aspose.Words. סוגי הצורות הם SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, ו DiagonalCornersRounded.

הצורה DML נוצרת באמצעות שיטת InsertShape עם סוגי צורות אלה. לא ניתן להשתמש בסוגים אלה כדי ליצור צורות VML. ניסיון ליצור צורה באמצעות הבונה הציבורי של כיתת " צורה “מעלה את החריג” NotSupportedException".

דוגמת הקוד הבאה מראה כיצד להכניס צורות מסוג זה למסמך:

קבל נקודות גבולות צורה בפועל

באמצעות Aspose.Words API, אתה יכול לקבל את המיקום והגודל של הצורה המכילה בלוק בנקודות, ביחס לעוגן של הצורה העליונה ביותר. לשם כך, השתמש במאפיין BoundsInPoints.

דוגמת הקוד הבאה מראה כיצד לעבוד עם המאפיין BoundsInPoints:

פורמט כלל אופקי

Aspose.Words API מספק את המאפיין HorizontalRuleFormat כדי לגשת למאפיינים של צורת הכלל האופקי. הכיתה HorizontalRuleFormat חושפת תכונות בסיסיות כמו גובה, צבע, צל, וכו'. לעיצוב של כלל אופקי.

הדוגמה הבאה של הקוד מראה כיצד להגדיר HorizontalRuleFormat:

הכנס OLE אובייקט כסמל

Aspose.Words API מספק Shape InsertOleObjectAsIcon פונקציה להכניס אובייקט מוטבע או מקושר OLE כסמל למסמך. פונקציה זו מאפשרת לציין את קובץ הסמל ואת הכיתוב. סוג האובייקט OLE יזוהה באמצעות סיומת הקובץ.

דוגמת הקוד הבאה מראה כיצד להגדיר הוספה OLE אובייקט כסמל למסמך:

הגודל המרבי של הסמל חייב להיות 32 על 32 לתצוגה הנכונה.