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`	قراءة	يُعيد الشكل.
`StoryType`	`StoryType`	قراءة	يُعيد مربع النص.
`ExtrusionEnabled`	`bool`	قراءة	يعيد true إذا تم تمكين تأثير البثق.
`ShadowEnabled`	`bool`	قراءة	يعيد true إذا تم تمكين تأثير الظل.
`Stroke`	`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`	قراءة	يوفر الوصول إلى خصائص المخطط إذا كان هذا 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`	قراءة	يحصل على is insert revision.
`IsDeleteRevision`	`bool`	قراءة	يحصل على نسخة الحذف.
`IsMoveFromRevision`	`bool`	قراءة	يحصل على is move من المراجعة.
`IsMoveToRevision`	`bool`	قراءة	يحصل على is move إلى المراجعة.
`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`	قراءة/كتابة	يحدد ما إذا كان الشكل مدمجًا أو عائمًا.
`WrapSide`	`WrapSide`	قراءة/كتابة	يحدد كيفية لف النص حول الشكل.
`CoordOrigin`	`Point`	قراءة/كتابة	الإحداثيات في الزاوية العليا اليسرى للكتلة الحاوية لهذا الشكل.
`CoordSize`	`Size`	قراءة/كتابة	العرض والارتفاع لمساحة الإحداثيات داخل الكتلة الحاوية لهذا الشكل.
`Font`	`Font`	قراءة	يوفّر الوصول إلى تنسيق الخط لهذا الكائن.
`IsSignatureLine`	`bool`	قراءة	يشير إلى أن الشكل هو SignatureLine.
`IsLayoutInCell`	`bool`	قراءة/كتابة	يحصل أو يحدد علمًا يشير إلى ما إذا كان الشكل معروضًا داخل جدول أو خارجه.
`Hidden`	`bool`	قراءة/كتابة	يحصل أو يحدد قيمة منطقية تشير إلى ما إذا كان الشكل مرئيًا.
`IsComposite`	`bool`	قراءة	يرجع true لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
`HasChildNodes`	`bool`	قراءة	يرجع true إذا كان لهذه العقدة أي عقد فرعية.
`FirstChild`	`Node`	قراءة	يحصل على الطفل الأول للعقدة.
`LastChild`	`Node`	قراءة	يحصل على الطفل الأخير للعقدة.
`Count`	`int`	قراءة	يحصل على عدد الأطفال المباشرين لهذا العقد.
`ParentNode`	`CompositeNode`	قراءة	يحصل على الوالد الفوري لهذه العقدة.
`Document`	`DocumentBase`	قراءة	يحصل على document الذي ينتمي إليه هذا node.
`PreviousSibling`	`Node`	قراءة	يحصل على العقدة التي تسبق هذه العقدة مباشرةً.
`NextSibling`	`Node`	قراءة	يحصل على العقدة التي تلي هذه العقدة مباشرةً.
`Range`	`Range`	قراءة	يرجع كائن Range يمثل الجزء من المستند الموجود داخل هذه العقدة.
`CustomNodeId`	`int`	قراءة/كتابة	يحدد معرف العقدة المخصص.

الطرق

التوقيع	وصف
`Shape(doc: DocumentBase, shapeType: ShapeType)`	ينشئ كائن شكل جديد.
`Accept(visitor: DocumentVisitor)`	ينادي VisitShapeStart، ثم ينادي Accept لجميع العقد الفرعية للشكل ويستدعي 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)`	يُرجِع العقدة الفرعية رقم N التي تطابق النوع المحدد.
`SelectNodes(xpath: string)`	يختار قائمة من العقد التي تطابق تعبير XPath.
`SelectSingleNode(xpath: string)`	يختار أول عقدة تتطابق مع تعبير 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) عندما يكون استنساخ العقدة جزءًا من عملية استنساخ عقدة أخرى (عادةً ما تكون مركبة).
`GetAncestor(ancestorType: Type)`	يحصل على السلف الأول من نوع الكائن المحدد.
`GetAncestorOf()`	يستدعي GetAncestorOf على كائن Shape هذا.
`Remove()`	يزيل نفسه من العنصر الأب.
`NextPreOrder(rootNode: Node)`	يحصل على العقدة التالية وفقًا لخوارزمية التجوال المسبق للشجرة.
`PreviousPreOrder(rootNode: Node)`	يحصل على العقدة السابقة وفقًا لخوارزمية التجوال المسبق للشجرة.
`ToString(saveFormat: SaveFormat)`	يصدر محتوى العقدة إلى سلسلة نصية بالتنسيق المحدد.
`NodeTypeToString(nodeType: NodeType)`	طريقة مساعدة تحول قيمة تعداد نوع العقدة إلى سلسلة نصية صديقة للمستخدم.

انظر أيضاً

Aspose.Words for .NET — Enterprise API Reference