## ShapeBase class

الفئة الأساسية للأشياء الموجودة في طبقة الرسم، مثل الشكل التلقائي، أو الشكل الحر، أو كائن OLE، أو عنصر تحكم ActiveX، أو الصورة.

لمعرفة المزيد، قم بزيارة[العمل مع الأشكال](https://docs.aspose.com/words/net/working-with-shapes/) مقالة توثيقية.

```csharp
public abstract class ShapeBase : CompositeNode
```

## الخصائص

| اسم | وصف |
| --- | --- |
| [AllowOverlap](../../aspose.words.drawing/shapebase/allowoverlap/) { get; set; } | يحصل على قيمة تحدد ما إذا كان هذا الشكل يمكنه التداخل مع الأشكال الأخرى أو يعينها. |
| [AlternativeText](../../aspose.words.drawing/shapebase/alternativetext/) { get; set; } | يحدد نصًا بديلًا ليتم عرضه بدلاً من الرسم البياني. |
| [AnchorLocked](../../aspose.words.drawing/shapebase/anchorlocked/) { get; set; } | يحدد ما إذا كان مرساة الشكل مقفلة. |
| [AspectRatioLocked](../../aspose.words.drawing/shapebase/aspectratiolocked/) { get; set; } | يحدد ما إذا كانت نسبة العرض إلى الارتفاع للشكل مقفلة. |
| [BehindText](../../aspose.words.drawing/shapebase/behindtext/) { get; set; } | يحدد ما إذا كان الشكل أسفل النص أم فوقه. |
| [Bottom](../../aspose.words.drawing/shapebase/bottom/) { get; } | يحصل على موضع الحافة السفلية للكتلة التي تحتوي على الشكل. |
| [Bounds](../../aspose.words.drawing/shapebase/bounds/) { get; set; } | يحصل على أو يعين موقع وحجم الكتلة التي تحتوي على الشكل. |
| [BoundsInPoints](../../aspose.words.drawing/shapebase/boundsinpoints/) { get; } | يحصل على موقع وحجم الكتلة التي تحتوي على الشكل بالنقاط، بالنسبة لمرساة الشكل الأعلى. |
| [BoundsWithEffects](../../aspose.words.drawing/shapebase/boundswitheffects/) { get; } | يحصل على المدى النهائي الذي أصبح عليه كائن الشكل هذا بعد تطبيق تأثيرات الرسم. يتم قياس القيمة بالنقاط. |
| [CanHaveImage](../../aspose.words.drawing/shapebase/canhaveimage/) { get; } | إرجاع`حقيقي` إذا كان نوع الشكل يسمح للشكل بالحصول على صورة. |
| [CoordOrigin](../../aspose.words.drawing/shapebase/coordorigin/) { get; set; } | الإحداثيات في الزاوية العلوية اليسرى من الكتلة التي تحتوي على هذا الشكل. |
| [CoordSize](../../aspose.words.drawing/shapebase/coordsize/) { get; set; } | عرض وارتفاع مساحة الإحداثيات داخل الكتلة التي تحتوي على هذا الشكل. |
| [Count](../../aspose.words/compositenode/count/) { get; } | يحصل على عدد الأبناء المباشرين لهذه العقدة. |
| [CustomNodeId](../../aspose.words/node/customnodeid/) { get; set; } | يحدد معرف العقدة المخصص. |
| [DistanceBottom](../../aspose.words.drawing/shapebase/distancebottom/) { get; set; } | يقوم بإرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة السفلية للشكل. |
| [DistanceLeft](../../aspose.words.drawing/shapebase/distanceleft/) { get; set; } | يقوم بإرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة اليسرى للشكل. |
| [DistanceRight](../../aspose.words.drawing/shapebase/distanceright/) { get; set; } | يقوم بإرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة اليمنى للشكل. |
| [DistanceTop](../../aspose.words.drawing/shapebase/distancetop/) { get; set; } | يقوم بإرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة العلوية للشكل. |
| virtual [Document](../../aspose.words/node/document/) { get; } | يحصل على المستند الذي تنتمي إليه هذه العقدة. |
| [Fill](../../aspose.words.drawing/shapebase/fill/) { get; } | يحصل على تنسيق التعبئة للشكل. |
| [FirstChild](../../aspose.words/compositenode/firstchild/) { get; } | يحصل على أول طفل للعقدة. |
| [FlipOrientation](../../aspose.words.drawing/shapebase/fliporientation/) { get; set; } | يقوم بتبديل اتجاه الشكل. |
| [Font](../../aspose.words.drawing/shapebase/font/) { get; } | يوفر الوصول إلى تنسيق الخط لهذا الكائن. |
| [Glow](../../aspose.words.drawing/shapebase/glow/) { get; } | يحصل على تنسيق التوهج للشكل. |
| [HasChildNodes](../../aspose.words/compositenode/haschildnodes/) { get; } | إرجاع`حقيقي` إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| [Height](../../aspose.words.drawing/shapebase/height/) { get; set; } | يحصل على ارتفاع الكتلة التي تحتوي على الشكل أو يعينه. |
| [HeightRelative](../../aspose.words.drawing/shapebase/heightrelative/) { get; set; } | يحصل على القيمة التي تمثل النسبة المئوية للارتفاع النسبي للشكل أو يعينها. |
| [Hidden](../../aspose.words.drawing/shapebase/hidden/) { get; set; } | يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان الشكل مرئيًا أم لا. |
| [HorizontalAlignment](../../aspose.words.drawing/shapebase/horizontalalignment/) { get; set; } | يحدد كيفية وضع الشكل أفقيًا. |
| [HRef](../../aspose.words.drawing/shapebase/href/) { get; set; } | يحصل على عنوان الارتباط التشعبي الكامل لشكل ما أو يعينه. |
| override [IsComposite](../../aspose.words/compositenode/iscomposite/) { get; } | إرجاع`حقيقي` حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية. |
| [IsDecorative](../../aspose.words.drawing/shapebase/isdecorative/) { get; set; } | يحصل على العلم الذي يحدد ما إذا كان الشكل مزخرفًا في المستند أم لا. |
| [IsDeleteRevision](../../aspose.words.drawing/shapebase/isdeleterevision/) { get; } | يعود صحيحًا إذا تم حذف هذا الكائن في Microsoft Word أثناء تمكين تتبع التغييرات. |
| [IsGroup](../../aspose.words.drawing/shapebase/isgroup/) { get; } | إرجاع`حقيقي` إذا كان هذا شكل المجموعة. |
| [IsHorizontalRule](../../aspose.words.drawing/shapebase/ishorizontalrule/) { get; } | إرجاع`حقيقي` إذا كان هذا الشكل عبارة عن مسطرة أفقية. |
| [IsImage](../../aspose.words.drawing/shapebase/isimage/) { get; } | إرجاع`حقيقي` إذا كان هذا الشكل هو شكل صورة. |
| [IsInline](../../aspose.words.drawing/shapebase/isinline/) { get; } | طريقة سريعة لتحديد ما إذا كان هذا الشكل موضوعًا في خط واحد مع النص. |
| [IsInsertRevision](../../aspose.words.drawing/shapebase/isinsertrevision/) { get; } | يعود صحيحًا إذا تم إدراج هذا الكائن في Microsoft Word أثناء تمكين تتبع التغييرات. |
| [IsLayoutInCell](../../aspose.words.drawing/shapebase/islayoutincell/) { get; set; } | يحصل على علم أو يعينه للإشارة إلى ما إذا كان الشكل معروضًا داخل جدول أو خارجه. |
| [IsMoveFromRevision](../../aspose.words.drawing/shapebase/ismovefromrevision/) { get; } | إرجاع`حقيقي` إذا تم نقل هذا الكائن (حذفه) في Microsoft Word أثناء تمكين تتبع التغييرات. |
| [IsMoveToRevision](../../aspose.words.drawing/shapebase/ismovetorevision/) { get; } | إرجاع`حقيقي` إذا تم نقل هذا الكائن (إدراجه) في Microsoft Word أثناء تمكين تتبع التغييرات. |
| [IsSignatureLine](../../aspose.words.drawing/shapebase/issignatureline/) { get; } | يشير إلى أن الشكل هو[`SignatureLine`](../signatureline/) . |
| [IsTopLevel](../../aspose.words.drawing/shapebase/istoplevel/) { get; } | إرجاع`حقيقي` إذا لم يكن هذا الشكل طفلاً لشكل المجموعة. |
| [IsWordArt](../../aspose.words.drawing/shapebase/iswordart/) { get; } | إرجاع`حقيقي` إذا كان هذا الشكل عبارة عن كائن WordArt. |
| [LastChild](../../aspose.words/compositenode/lastchild/) { get; } | يحصل على آخر طفل للعقدة. |
| [Left](../../aspose.words.drawing/shapebase/left/) { get; set; } | يحصل على موضع الحافة اليسرى للكتلة التي تحتوي على الشكل أو يعينه. |
| [LeftRelative](../../aspose.words.drawing/shapebase/leftrelative/) { get; set; } | يحصل على القيمة التي تمثل الموضع النسبي للشكل على اليسار كنسبة مئوية أو يعينها. |
| [MarkupLanguage](../../aspose.words.drawing/shapebase/markuplanguage/) { get; } | يحصل على MarkupLanguage المستخدم لهذا الكائن الرسومي. |
| [Name](../../aspose.words.drawing/shapebase/name/) { get; set; } | يحصل على اسم الشكل الاختياري أو يعينه. |
| [NextSibling](../../aspose.words/node/nextsibling/) { get; } | يحصل على العقدة التي تلي هذه العقدة مباشرة. |
| abstract [NodeType](../../aspose.words/node/nodetype/) { get; } | يحصل على نوع هذه العقدة. |
| [ParentNode](../../aspose.words/node/parentnode/) { get; } | يحصل على الوالد المباشر لهذه العقدة. |
| [ParentParagraph](../../aspose.words.drawing/shapebase/parentparagraph/) { get; } | إرجاع الفقرة الأصلية المباشرة. |
| [PreviousSibling](../../aspose.words/node/previoussibling/) { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرةً. |
| [Range](../../aspose.words/node/range/) { get; } | يعيد[`Range`](../../aspose.words/range/)الكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة. |
| [Reflection](../../aspose.words.drawing/shapebase/reflection/) { get; } | يحصل على تنسيق الانعكاس للشكل. |
| [RelativeHorizontalPosition](../../aspose.words.drawing/shapebase/relativehorizontalposition/) { get; set; } | يحدد بالنسبة إلى ما يتم وضع الشكل أفقيًا. |
| [RelativeHorizontalSize](../../aspose.words.drawing/shapebase/relativehorizontalsize/) { get; set; } | يحصل على قيمة الحجم النسبي للشكل في الاتجاه الأفقي أو يعينها. |
| [RelativeVerticalPosition](../../aspose.words.drawing/shapebase/relativeverticalposition/) { get; set; } | يحدد بالنسبة إلى الوضع الرأسي للشكل. |
| [RelativeVerticalSize](../../aspose.words.drawing/shapebase/relativeverticalsize/) { get; set; } | يحصل على قيمة الحجم النسبي للشكل في الاتجاه الرأسي أو يعينها. |
| [Right](../../aspose.words.drawing/shapebase/right/) { get; } | يحصل على موضع الحافة اليمنى للكتلة التي تحتوي على الشكل. |
| [Rotation](../../aspose.words.drawing/shapebase/rotation/) { get; set; } | يحدد الزاوية (بالدرجات) التي يدور بها الشكل. القيمة الإيجابية تتوافق مع زاوية الدوران في اتجاه عقارب الساعة. |
| [ScreenTip](../../aspose.words.drawing/shapebase/screentip/) { get; set; } | يحدد النص المعروض عند تحرك مؤشر الماوس فوق الشكل. |
| [ShadowFormat](../../aspose.words.drawing/shapebase/shadowformat/) { get; } | يحصل على تنسيق الظل للشكل. |
| [ShapeType](../../aspose.words.drawing/shapebase/shapetype/) { get; } | يحصل على نوع الشكل. |
| [SizeInPoints](../../aspose.words.drawing/shapebase/sizeinpoints/) { get; } | يحصل على حجم الشكل بالنقاط. |
| [SoftEdge](../../aspose.words.drawing/shapebase/softedge/) { get; } | يحصل على تنسيق الحافة الناعمة للشكل. |
| [Target](../../aspose.words.drawing/shapebase/target/) { get; set; } | يحصل على إطار الهدف لرابط الشكل التشعبي أو يعينه. |
| [Title](../../aspose.words.drawing/shapebase/title/) { get; set; } | يحصل على عنوان (التعليق التوضيحي) لكائن الشكل الحالي أو يعينه. |
| [Top](../../aspose.words.drawing/shapebase/top/) { get; set; } | يحصل على موضع الحافة العلوية للكتلة التي تحتوي على الشكل أو يعينه. |
| [TopRelative](../../aspose.words.drawing/shapebase/toprelative/) { get; set; } | يحصل على القيمة التي تمثل الموضع العلوي النسبي للشكل كنسبة مئوية أو يعينها. |
| [VerticalAlignment](../../aspose.words.drawing/shapebase/verticalalignment/) { get; set; } | يحدد كيفية وضع الشكل عموديًا. |
| [Width](../../aspose.words.drawing/shapebase/width/) { get; set; } | يحصل على عرض الكتلة التي تحتوي على الشكل أو يعينه. |
| [WidthRelative](../../aspose.words.drawing/shapebase/widthrelative/) { get; set; } | يحصل على القيمة التي تمثل النسبة المئوية للعرض النسبي للشكل أو يعينها. |
| [WrapSide](../../aspose.words.drawing/shapebase/wrapside/) { get; set; } | يحدد كيفية لف النص حول الشكل. |
| [WrapType](../../aspose.words.drawing/shapebase/wraptype/) { get; set; } | يُحدد ما إذا كان الشكل مضمنًا أم عائمًا. بالنسبة للأشكال العائمة، يُحدد وضع التفاف النص حول الشكل. |
| [ZOrder](../../aspose.words.drawing/shapebase/zorder/) { get; set; } | يحدد ترتيب عرض الأشكال المتداخلة. |

## طُرق

| اسم | وصف |
| --- | --- |
| abstract [Accept](../../aspose.words/node/accept/)(*[DocumentVisitor](../../aspose.words/documentvisitor/)*) | يقبل زائرًا. |
| abstract [AcceptEnd](../../aspose.words/compositenode/acceptend/)(*[DocumentVisitor](../../aspose.words/documentvisitor/)*) | عند تنفيذه في فئة مشتقة، يتم استدعاء طريقة VisitXXXEnd للزائر المستند المحدد. |
| abstract [AcceptStart](../../aspose.words/compositenode/acceptstart/)(*[DocumentVisitor](../../aspose.words/documentvisitor/)*) | عند تنفيذه في فئة مشتقة، يتم استدعاء طريقة VisitXXXStart للزائر المستند المحدد. |
| [AdjustWithEffects](../../aspose.words.drawing/shapebase/adjustwitheffects/)(*RectangleF*) | يضيف إلى قيم المستطيل المصدر لمدى التأثير ويعيد المستطيل النهائي. |
| [AppendChild<T>](../../aspose.words/compositenode/appendchild/)(*T*) | يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة. |
| [Clone](../../aspose.words/node/clone/)(*bool*) | ينشئ نسخة مكررة من العقدة. |
| [CreateNavigator](../../aspose.words/compositenode/createnavigator/)() | ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها. |
| [GetAncestor](../../aspose.words/node/getancestor/)(*[NodeType](../../aspose.words/nodetype/)*) | يحصل على السلف الأول للعنصر المحدد[`NodeType`](../../aspose.words/nodetype/) . |
| [GetAncestor](../../aspose.words/node/getancestor/)(*Type*) | يحصل على السلف الأول لنوع الكائن المحدد. |
| [GetChild](../../aspose.words/compositenode/getchild/)(*[NodeType](../../aspose.words/nodetype/), int, bool*) | يعيد عقدة فرعية رقم N تطابق النوع المحدد. |
| [GetChildNodes](../../aspose.words/compositenode/getchildnodes/)(*[NodeType](../../aspose.words/nodetype/), bool*) | يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد. |
| [GetEnumerator](../../aspose.words/compositenode/getenumerator/)() | يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة. |
| [GetShapeRenderer](../../aspose.words.drawing/shapebase/getshaperenderer/)() | ينشئ ويعيد كائنًا يمكن استخدامه لتحويل هذا الشكل إلى صورة. |
| override [GetText](../../aspose.words/compositenode/gettext/)() | يحصل على نص هذه العقدة وجميع أبنائها. |
| [IndexOf](../../aspose.words/compositenode/indexof/)(*[Node](../../aspose.words/node/)*) | يعيد مؤشر العقدة الفرعية المحددة في مجموعة العقد الفرعية. |
| [InsertAfter<T>](../../aspose.words/compositenode/insertafter/)(*T, [Node](../../aspose.words/node/)*) | يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة. |
| [InsertBefore<T>](../../aspose.words/compositenode/insertbefore/)(*T, [Node](../../aspose.words/node/)*) | يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة. |
| [LocalToParent](../../aspose.words.drawing/shapebase/localtoparent/)(*PointF*) | يحول قيمة من مساحة الإحداثيات المحلية إلى مساحة الإحداثيات للشكل الأصلي. |
| [NextPreOrder](../../aspose.words/node/nextpreorder/)(*[Node](../../aspose.words/node/)*) | يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| [PrependChild<T>](../../aspose.words/compositenode/prependchild/)(*T*) | يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة. |
| [PreviousPreOrder](../../aspose.words/node/previouspreorder/)(*[Node](../../aspose.words/node/)*) | يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| [Remove](../../aspose.words/node/remove/)() | يزيل نفسه من الأصل. |
| [RemoveAllChildren](../../aspose.words/compositenode/removeallchildren/)() | يزيل جميع العقد الفرعية للعقدة الحالية. |
| [RemoveChild<T>](../../aspose.words/compositenode/removechild/)(*T*) | يزيل العقدة الفرعية المحددة. |
| [RemoveSmartTags](../../aspose.words/compositenode/removesmarttags/)() | يزيل الكل[`SmartTag`](../../aspose.words.markup/smarttag/) العقد المنحدرة من العقدة الحالية. |
| [SelectNodes](../../aspose.words/compositenode/selectnodes/)(*string*) | يحدد قائمة العقد المطابقة لتعبير XPath. |
| [SelectSingleNode](../../aspose.words/compositenode/selectsinglenode/)(*string*) | يحدد الأول[`Node`](../../aspose.words/node/) الذي يتطابق مع تعبير XPath. |
| [ToString](../../aspose.words/node/tostring/)(*[SaveFormat](../../aspose.words/saveformat/)*) | يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| [ToString](../../aspose.words/node/tostring/)(*[SaveOptions](../../aspose.words.saving/saveoptions/)*) | يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |

## ملاحظات

هذه فئة مجردة. الفئتان المشتقتان اللتان يمكنك إنشاء مثيل لهما هما[`Shape`](../shape/) و[`GroupShape`](../groupshape/).

الشكل هو عقدة في شجرة المستند.

إذا كان الشكل طفلاً لـ[`Paragraph`](../../aspose.words/paragraph/) إذا كان الكائن عبارة عن "مستوى أعلى"، فيُقال عن الشكل أنه "مستوى أعلى". يتم قياس الأشكال ذات المستوى الأعلى وتحديد موضعها في نقاط.

يمكن أن يحدث الشكل أيضًا كطفل لـ[`GroupShape`](../groupshape/) الكائن عند تجميع عدة أشكال x000d_. تُوضع الأشكال الفرعية لشكل المجموعة في مساحة الإحداثيات، وتُحدد الوحدات x000d_ بواسطة[`CoordSize`](./coordsize/) و[`CoordOrigin`](./coordorigin/) خصائص شكل المجموعة parent .

يمكن وضع الشكل ضمن النص أو عائمًا. يتم التحكم في طريقة الوضع باستخدام[`WrapType`](./wraptype/) ملكية.

عندما يكون الشكل عائمًا، يُحدَّد موضعه بالنسبة لشيء ما (مثل الفقرة الحالية، أو الهامش، أو الصفحة). يُحدَّد الموضع النسبي للشكل باستخدام الدالة x000d.[`RelativeHorizontalPosition`](./relativehorizontalposition/) و[`RelativeVerticalPosition`](./relativeverticalposition/) ملكيات.

يمكن وضع الشكل العائم بشكل صريح باستخدام[`Left`](./left/) و[`Top`](./top/) خصائص أو محاذاتها بالنسبة إلى بعض الكائنات الأخرى باستخدام[`HorizontalAlignment`](./horizontalalignment/) و[`VerticalAlignment`](./verticalalignment/) ملكيات.

## أمثلة

يوضح كيفية إدراج صورة عائمة في وسط الصفحة.

```csharp
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// قم بإدراج صورة عائمة ستظهر خلف النص المتداخل وقم بمحاذاتها مع مركز الصفحة.
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
shape.WrapType = WrapType.None;
shape.BehindText = true;
shape.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
shape.RelativeVerticalPosition = RelativeVerticalPosition.Page;
shape.HorizontalAlignment = HorizontalAlignment.Center;
shape.VerticalAlignment = VerticalAlignment.Center;

doc.Save(ArtifactsDir + "Image.CreateFloatingPageCenter.docx");
```

### أنظر أيضا

* class [CompositeNode](../../aspose.words/compositenode/)
* مساحة الاسم [Aspose.Words.Drawing](../../aspose.words.drawing/)
* المجسم [Aspose.Words](../../)