Shape

סקירה כללית

Shape היא מחלקה ב-Aspose.Words FOSS עבור .NET. יורשת מ-: ShapeBase, ITextBox, IStrokable.

מייצג אובייקט בשכבת הציור, כגון AutoShape, תיבת טקסט, צורה חופשית, אובייקט OLE, פקד ActiveX או תמונה.

מחלקה זו מספקת 29 שיטות לעבודה עם אובייקטי Shape בתוכניות .NET. השיטות הזמינות כוללות: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator, ו-17 שיטות נוספות. כל החברים הציבוריים נגישים לכל יישום .NET לאחר התקנת חבילת Aspose.Words FOSS עבור .NET. מאפיינים: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText, ו-93 נוספים.

מאפיינים

שם	סוג	גישה	תיאור
`NodeType`	`NodeType`	קריאה	מחזיר Shape.
`StoryType`	`StoryType`	קריאה	מחזיר Textbox.
`ExtrusionEnabled`	`bool`	קריאה	מחזיר true אם אפקט חצייה מופעל.
`ShadowEnabled`	`bool`	קריאה	מחזיר true אם אפקט צל מופעל.
`Stroke`	`Stroke`	קריאה	מגדיר קו מתאר לצורה.
`Stroked`	`bool`	קריאה/כתיבה	מגדיר האם הנתיב יעבור קו מתאר.
`StrokeWeight`	`double`	קריאה/כתיבה	מגדיר את עובי המברשת שמצייר קו מתאר לנתיב של הצורה בנקודות.
`StrokeColor`	`Color`	קריאה/כתיבה	מגדיר את צבע הקו המתאר.
`Filled`	`bool`	קריאה/כתיבה	קובע האם הנתיב הסגור של הצורה ימולא.
`FillColor`	`Color`	קריאה/כתיבה	מגדיר את צבע המברשת שממלא את הנתיב הסגור של הצורה.
`HasImage`	`bool`	קריאה	מחזיר true אם לצורה יש בתים של תמונה או מקשר תמונה.
`ImageData`	`ImageData`	קריאה	מספק גישה לתמונה של הצורה.
`OleFormat`	`OleFormat`	קריאה	מספק גישה לנתוני OLE של צורה.
`TextBox`	`TextBox`	קריאה	מגדיר מאפיינים שמציינים כיצד הטקסט מוצג בצורה.
`TextPath`	`TextPath`	קריאה	מגדיר את הטקסט של נתיב הטקסט (של אובייקט WordArt).
`FirstParagraph`	`Paragraph`	קריאה	מקבל את הפסקה הראשונה בצורה.
`LastParagraph`	`Paragraph`	קריאה	מקבל את הפסקה האחרונה בצורה.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	קריאה	מספק גישה למאפייני צורת קו האופקי.
`Adjustments`	`AdjustmentCollection`	קריאה	מספק גישה לערכי ההתאמה הגולמיים של צורה.
`SignatureLine`	`SignatureLine`	קריאה	מקבל את האובייקט `SignatureLine` אם הצורה היא קו חתימה.
`HasChart`	`bool`	קריאה	מחזיר true אם ל-Shape הזה יש Chart.
`HasSmartArt`	`bool`	קריאה	מחזיר true אם ל-Shape הזה יש אובייקט SmartArt.
`Chart`	`Chart`	קריאה	מספק גישה למאפייני ה-Chart אם ל-shape הזה יש Chart.
`Fill`	`Fill`	קריאה	מקבל עיצוב מילוי עבור הצורה.
`ShadowFormat`	`ShadowFormat`	קריאה	מקבל עיצוב צל עבור הצורה.
`Glow`	`GlowFormat`	קריאה	מקבל פורמט זוהר עבור הצורה.
`Reflection`	`ReflectionFormat`	קריאה	מקבל עיצוב השתקפות עבור הצורה.
`SoftEdge`	`SoftEdgeFormat`	קריאה	מקבל עיצוב קצוות רכים עבור הצורה.
`ScreenTip`	`string`	קריאה/כתיבה	מגדיר את הטקסט שמוצג כאשר מצביע העכבר נע מעל הצורה.
`HRef`	`string`	קריאה/כתיבה	מקבל או מגדיר את כתובת הקישור המלאה לצורה.
`Target`	`string`	קריאה/כתיבה	מקבל או מגדיר את מסגרת היעד לקישור הצורה.
`AlternativeText`	`string`	קריאה/כתיבה	מגדיר טקסט חלופי שיוצג במקום גרפיקה.
`IsDecorative`	`bool`	קריאה/כתיבה	מקבל או מגדיר את הדגל שמציין אם הצורה היא דקורטיבית במסמך.
`Title`	`string`	קריאה/כתיבה	מקבל או מגדיר את הכותרת (הכתובית) של אובייקט הצורה הנוכחי.
`Name`	`string`	קריאה/כתיבה	מקבל או מגדיר את שם הצורה האופציונלי.
`IsInsertRevision`	`bool`	קריאה	מקבל את `IsInsertRevision`.
`IsDeleteRevision`	`bool`	קריאה	מקבל את גרסת המחיקה.
`IsMoveFromRevision`	`bool`	קריאה	מקבל את is move מ-revision.
`IsMoveToRevision`	`bool`	קריאה	מקבל את `isMoveToRevision`.
`IsTopLevel`	`bool`	קריאה	מחזיר true אם הצורה הזו איננה בן של צורת קבוצה.
`IsGroup`	`bool`	קריאה	מחזיר true אם זו צורת קבוצה.
`IsImage`	`bool`	קריאה	מחזירה true אם הצורה הזאת היא צורת תמונה.
`IsHorizontalRule`	`bool`	קריאה	מחזירה true אם הצורה הזאת היא קו אופקי.
`IsWordArt`	`bool`	קריאה	מחזיר true אם הצורה הזו היא אובייקט WordArt.
`CanHaveImage`	`bool`	קריאה	מחזיר true אם סוג הצורה מאפשר לצורה לקבל תמונה.
`AnchorLocked`	`bool`	קריאה/כתיבה	מציין האם העוגן של הצורה נעול.
`AspectRatioLocked`	`bool`	קריאה/כתיבה	מציין האם יחס הממדים של הצורה נעול.
`AllowOverlap`	`bool`	קריאה/כתיבה	מקבל או מגדיר ערך שמציין האם הצורה הזו יכולה לחפוף צורות אחרות.
`BehindText`	`bool`	קריאה/כתיבה	מציין האם הצורה ממוקמת מתחת או מעל הטקסט.
`IsInline`	`bool`	קריאה	דרך מהירה לקבוע אם הצורה הזו ממוקמת בשורה עם הטקסט.
`Left`	`double`	קריאה/כתיבה	מקבל או מגדיר את המיקום של הקצה השמאלי של בלוק המכולה של הצורה.
`Top`	`double`	קריאה/כתיבה	מקבל או מגדיר את המיקום של הקצה העליון של הבלוק המכולה של הצורה.
`Right`	`double`	קריאה	מקבל את המיקום של הקצה הימני של הבלוק המכולה של הצורה.
`Bottom`	`double`	קריאה	מקבל את המיקום של הקצה התחתון של הבלוק המכולה של הצורה.
`Width`	`double`	קריאה/כתיבה	מקבל או מגדיר את הרוחב של הבלוק המכיל של הצורה.
`Height`	`double`	קריאה/כתיבה	מקבל או מגדיר את הגובה של הבלוק המכיל את הצורה.
`DistanceTop`	`double`	קריאה/כתיבה	מחזיר או מגדיר את המרחק (בנקודות) בין טקסט המסמך לקצה העליון של הצורה.
`DistanceBottom`	`double`	קריאה/כתיבה	מחזיר או מגדיר את המרחק (בנקודות) בין טקסט המסמך לקצה התחתון של הצורה.
`DistanceLeft`	`double`	קריאה/כתיבה	מחזיר או מגדיר את המרחק (בנקודות) בין טקסט המסמך לבין הקצה השמאלי של הצורה.
`DistanceRight`	`double`	קריאה/כתיבה	מחזיר או מגדיר את המרחק (בנקודות) בין טקסט המסמך לבין הקצה הימני של הצורה.
`Rotation`	`double`	קריאה/כתיבה	מגדיר את הזווית (במעלות) שבה הצורה מסובבת.
`ZOrder`	`int`	קריאה/כתיבה	קובע את סדר התצוגה של צורות חופפות.
`ParentParagraph`	`Paragraph`	קריאה	מחזיר את הפסקה ההורה המיידית.
`Bounds`	`RectangleF`	קריאה/כתיבה	מקבל או מגדיר את המיקום והגודל של בלוק המכולה של הצורה.
`BoundsInPoints`	`RectangleF`	קריאה	מקבל את המיקום והגודל של בלוק המכולה של הצורה בנקודות, ביחס לעוגן של הצורה העליונה ביותר.
`BoundsWithEffects`	`RectangleF`	קריאה	מקבל את המימד הסופי של אובייקט הצורה הזה לאחר יישום אפקטי הציור.
`ShapeType`	`ShapeType`	קריאה	מקבל את סוג הצורה.
`MarkupLanguage`	`ShapeMarkupLanguage`	קריאה	מקבל את MarkupLanguage המשמש עבור אובייקט גרפי זה.
`SizeInPoints`	`SizeF`	קריאה	מקבל את הגודל של הצורה בנקודות.
`FlipOrientation`	`FlipOrientation`	קריאה/כתיבה	משנה את הכיוון של הצורה.
`RelativeHorizontalPosition`	`RelativeHorizontalPosition`	קריאה/כתיבה	מציין יחסית למה שהצורה ממוקמת אופקית.
`RelativeVerticalPosition`	`RelativeVerticalPosition`	קריאה/כתיבה	מציין יחסית למה שהצורה ממוקמת אנכית.
`RelativeHorizontalSize`	`RelativeHorizontalSize`	קריאה/כתיבה	מקבל או מגדיר את ערך הגודל היחסי של הצורה בכיוון האופקי.
`RelativeVerticalSize`	`RelativeVerticalSize`	קריאה/כתיבה	מקבל או מגדיר את הערך של הגודל היחסי של הצורה בכיוון האנכי.
`LeftRelative`	`float`	קריאה/כתיבה	מקבל או מגדיר את הערך המייצג את המיקום השמאלי היחסי של הצורה באחוזים.
`TopRelative`	`float`	קריאה/כתיבה	מקבל או מגדיר את הערך שמייצג את המיקום העליון היחסי של הצורה באחוזים.
`HeightRelative`	`float`	קריאה/כתיבה	מקבל או מגדיר את הערך שמייצג את האחוז של הגובה היחסי של הצורה.
`WidthRelative`	`float`	קריאה/כתיבה	מקבל או מגדיר את הערך שמייצג את האחוז של הרוחב היחסי של הצורה.
`HorizontalAlignment`	`HorizontalAlignment`	קריאה/כתיבה	מציין כיצד הצורה ממוקמת אופקית.
`VerticalAlignment`	`VerticalAlignment`	קריאה/כתיבה	מציין כיצד הצורה ממוקמת אנכית.
`WrapType`	`WrapType`	קריאה/כתיבה	מגדיר האם הצורה היא inline או floating.
`WrapSide`	`WrapSide`	קריאה/כתיבה	מציין כיצד הטקסט מתעטף סביב הצורה.
`CoordOrigin`	`Point`	קריאה/כתיבה	הקואורדינטות בפינה העליונה השמאלית של הבלוק המכיל של הצורה הזו.
`CoordSize`	`Size`	קריאה/כתיבה	הרוחב והגובה של מרחב הקואורדינטות בתוך הבלוק המכיל של הצורה הזו.
`Font`	`Font`	קריאה	מספק גישה לעיצוב הגופן של האובייקט הזה.
`IsSignatureLine`	`bool`	קריאה	מצביע על כך שהצורה היא SignatureLine.
`IsLayoutInCell`	`bool`	קריאה/כתיבה	מקבל או מגדיר מתג המציין האם הצורה מוצגת בתוך טבלה או מחוצה לה.
`Hidden`	`bool`	קריאה/כתיבה	מקבל או מגדיר ערך בוליאני המציין האם הצורה נראית.
`IsComposite`	`bool`	קריאה	מחזיר true מכיוון שהצומת הזה יכול להכיל צמתים ילדים.
`HasChildNodes`	`bool`	קריאה	מחזיר true אם ל-node זה יש צמתים ילדים.
`FirstChild`	`Node`	קריאה	מקבל את הילד הראשון של הצומת.
`LastChild`	`Node`	קריאה	מקבל את הילד האחרון של הצומת.
`Count`	`int`	קריאה	מקבל את מספר הילדים הישירים של צומת זה.
`ParentNode`	`CompositeNode`	קריאה	מקבל את ההורה המיידי של הצומת הזה.
`Document`	`DocumentBase`	קריאה	מקבל את המסמך שאליו צומת זה שייך.
`PreviousSibling`	`Node`	קריאה	מקבל את הצומת הממוקם מיד לפני הצומת הזה.
`NextSibling`	`Node`	קריאה	מקבל את הצומת שמיד אחרי הצומת הזה.
`Range`	`Range`	קריאה	מחזיר אובייקט Range שמייצג את החלק של מסמך שנמצא בתוך הצומת הזה.
`CustomNodeId`	`int`	קריאה/כתיבה	מציין מזהה צומת מותאם אישית.

שיטות

חתימה	תיאור
`Shape(doc: DocumentBase, shapeType: ShapeType)`	יוצר אובייקט shape חדש.
`Accept(visitor: DocumentVisitor)`	קורא ל-VisitShapeStart, ואז קורא ל-Accept עבור כל צמתים הבנים של ה-shape וקורא ל-VisitShapeEnd בסיום.
`AcceptStart(visitor: DocumentVisitor)`	מקבל מבקר לביקור בתחילת הצורה.
`AcceptEnd(visitor: DocumentVisitor)`	מקבל מבקר לביקור בסוף הצורה.
`LocalToParent(value: PointF)`	ממיר ערך ממרחב הקואורדינטות המקומי למרחב הקואורדינטות של הצורה ההורית.
`AdjustWithEffects(source: RectangleF)`	מוסיף למלבן המקור את ערכי היקף האפקט ומחזיר את המלבן הסופי.
`GetText()`	מקבל את הטקסט של צומת זה ושל כל ילדיו.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	מחזיר אוסף של צמתים צאצאים המתאימים לסוג המוגדר.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	מחזיר את הצומת הצאצאי ה-Nth התואם לסוג המוגדר.
`SelectNodes(xpath: string)`	בוחר רשימת צמתים התואמים לביטוי XPath.
`SelectSingleNode(xpath: string)`	בוחר את ה-Node הראשון המתאים לביטוי XPath.
`GetEnumerator()`	מספק תמיכה באיטרציה בסגנון for each על צמתים צאצאיים של צומת זה.
`AppendChild(newChild: T)`	מוסיף את הצומת המצויין לסוף רשימת הצמתים הצאצאיים של צומת זה.
`PrependChild(newChild: T)`	מוסיף את הצומת המצויין להתחלת רשימת הצמתים הצאצאיים של צומת זה.
`InsertAfter(newChild: T, refChild: Node)`	מכניס את הצומת המוגדר מייד לאחר צומת ההתייחסות המוגדר.
`InsertBefore(newChild: T, refChild: Node)`	מכניס את הצומת שצוין מיד לפני צומת ההתייחסות שצוין.
`RemoveChild(oldChild: T)`	מסיר את צומת הבן שצוין.
`RemoveAllChildren()`	מסיר את כל צמתות הבן של הצומת הנוכחי.
`RemoveSmartTags()`	מסיר את כל צמתות הצאצא של SmartTag של הצומת הנוכחי.
`IndexOf(child: Node)`	מחזיר את האינדקס של צומת הילד המצויין במערך צמתים הילד.
`CreateNavigator()`	יוצר לנווט שניתן להשתמש בו כדי לעבור ולקרוא צמתים.
`Clone(isCloneChildren: bool)`	אתה צריך להשתמש ב-Clone(bool, INodeCloningListener) overload כאשר שכפול הצומת הוא חלק מתהליך שכפול של צומת אחר (בדרך כלל משולב).
`GetAncestor(ancestorType: Type)`	מקבל את האבות הראשון של סוג האובייקט שצוין.
`GetAncestorOf()`	קורא ל-GetAncestorOf על מופע Shape זה.
`Remove()`	מסיר את עצמו מההורה.
`NextPreOrder(rootNode: Node)`	מקבל את הצומת הבא על פי אלגוריתם מסע העץ בקדימה מראש.
`PreviousPreOrder(rootNode: Node)`	מקבל את הצומת הקודם על פי אלגוריתם מסע העץ בקדימה מראש.
`ToString(saveFormat: SaveFormat)`	מייצא את תוכן הצומת למחרוזת בפורמט שצוין.
`NodeTypeToString(nodeType: NodeType)`	מתודה שימושית שממירה ערך enum של סוג צומת למחרוזת ידידותית למשתמש.

ראה גם

Aspose.Words for .NET — Enterprise API Reference