ShapeBase
محتويات
[
يخفي
]ShapeBase class
الفئة الأساسية للكائنات الموجودة في طبقة الرسم، مثل الشكل التلقائي أو الشكل الحر أو كائن OLE أو عنصر تحكم ActiveX أو الصورة.
لمعرفة المزيد، قم بزيارةالعمل مع الأشكال مقالة توثيقية.
public abstract class ShapeBase : CompositeNode
الخصائص
| اسم | وصف |
|---|---|
| AllowOverlap { get; set; } | الحصول على أو تعيين القيمة التي تحدد ما إذا كان هذا الشكل يمكن أن يتداخل مع الأشكال الأخرى. |
| AlternativeText { get; set; } | تحديد النص البديل الذي سيتم عرضه بدلاً من الرسم. |
| AnchorLocked { get; set; } | يحدد ما إذا كان رابط الشكل مقفلاً أم لا. |
| AspectRatioLocked { get; set; } | يحدد ما إذا كانت نسبة العرض إلى الارتفاع للشكل مقفلة أم لا. |
| BehindText { get; set; } | يحدد ما إذا كان الشكل أسفل النص أو فوقه. |
| Bottom { get; } | الحصول على موضع الحافة السفلية للكتلة التي تحتوي على الشكل. |
| Bounds { get; set; } | الحصول على أو تعيين موقع وحجم الكتلة التي تحتوي على الشكل. |
| BoundsInPoints { get; } | الحصول على موقع وحجم الكتلة التي تحتوي على الشكل بالنقاط، بالنسبة إلى نقطة ارتساء الشكل العلوي. |
| BoundsWithEffects { get; } | الحصول على المدى النهائي لكائن الشكل هذا بعد تطبيق تأثيرات الرسم. يتم قياس القيمة بالنقاط. |
| CanHaveImage { get; } | إرجاعحقيقي إذا كان نوع الشكل يسمح للشكل بأن يكون له صورة. |
| CoordOrigin { get; set; } | الإحداثيات في الزاوية العلوية اليسرى للكتلة التي تحتوي على هذا الشكل. |
| CoordSize { get; set; } | عرض وارتفاع مساحة الإحداثيات داخل الكتلة المحتوية على هذا الشكل. |
| Count { get; } | يحصل على عدد الأطفال المباشرين لهذه العقدة. |
| CustomNodeId { get; set; } | يحدد معرف العقدة المخصصة. |
| DistanceBottom { get; set; } | إرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة السفلية للشكل. |
| DistanceLeft { get; set; } | إرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة اليسرى للشكل. |
| DistanceRight { get; set; } | إرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة اليمنى للشكل. |
| DistanceTop { get; set; } | إرجاع أو تعيين المسافة (بالنقاط) بين نص المستند والحافة العلوية للشكل. |
| virtual Document { get; } | الحصول على المستند الذي تنتمي إليه هذه العقدة. |
| Fill { get; } | الحصول على تنسيق التعبئة للشكل. |
| FirstChild { get; } | يحصل على الطفل الأول للعقدة. |
| FlipOrientation { get; set; } | تبديل اتجاه الشكل. |
| Font { get; } | يوفر الوصول إلى تنسيق الخط لهذا الكائن. |
| HasChildNodes { get; } | إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| Height { get; set; } | الحصول على أو تعيين ارتفاع الكتلة التي تحتوي على الشكل. |
| HeightRelative { get; set; } | الحصول على أو تعيين القيمة التي تمثل النسبة المئوية للارتفاع النسبي للشكل. |
| HorizontalAlignment { get; set; } | يحدد كيفية وضع الشكل أفقيًا. |
| HRef { get; set; } | الحصول على عنوان الارتباط التشعبي الكامل للشكل أو تعيينه. |
| override IsComposite { get; } | إرجاعحقيقي لأن هذه العقدة يمكن أن تحتوي على عقد فرعية. |
| IsDecorative { get; set; } | الحصول على أو تعيين العلامة التي تحدد ما إذا كان الشكل مزخرفًا في المستند. |
| IsDeleteRevision { get; } | إرجاع صحيح إذا تم حذف هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsGroup { get; } | إرجاعحقيقي إذا كان هذا شكل مجموعة. |
| IsHorizontalRule { get; } | إرجاعحقيقي إذا كان هذا الشكل مسطرة أفقية. |
| IsImage { get; } | إرجاعحقيقي إذا كان هذا الشكل عبارة عن شكل صورة. |
| IsInline { get; } | طريقة سريعة لتحديد ما إذا كان هذا الشكل تم وضعه سطريًا مع النص. |
| IsInsertRevision { get; } | إرجاع صحيح إذا تم إدراج هذا الكائن في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsLayoutInCell { get; set; } | الحصول على أو تعيين علامة تشير إلى ما إذا كان الشكل معروضًا داخل الجدول أم خارجه. |
| IsMoveFromRevision { get; } | إرجاعحقيقي إذا تم نقل هذا الكائن (حذفه) في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsMoveToRevision { get; } | إرجاعحقيقي إذا تم نقل هذا الكائن (إدراجه) في Microsoft Word أثناء تمكين تعقب التغييرات. |
| IsSignatureLine { get; } | يشير إلى أن الشكل هو أSignatureLine . |
| IsTopLevel { get; } | إرجاعحقيقيإذا لم يكن هذا الشكل تابعًا لشكل المجموعة. |
| IsWordArt { get; } | إرجاعحقيقي إذا كان هذا الشكل عبارة عن كائن WordArt. |
| LastChild { get; } | يحصل على الطفل الأخير للعقدة. |
| Left { get; set; } | الحصول على أو تعيين موضع الحافة اليسرى للكتلة التي تحتوي على الشكل. |
| LeftRelative { get; set; } | الحصول على أو تعيين القيمة التي تمثل الموضع الأيسر النسبي للشكل بالنسبة المئوية. |
| MarkupLanguage { get; } | يحصل على لغة الترميز المستخدمة لهذا الكائن الرسومي. |
| Name { get; set; } | الحصول على اسم الشكل الاختياري أو تعيينه. |
| NextSibling { get; } | يحصل على العقدة التي تلي هذه العقدة مباشرة. |
| abstract NodeType { get; } | يحصل على نوع هذه العقدة. |
| ParentNode { get; } | يحصل على الأصل المباشر لهذه العقدة. |
| ParentParagraph { get; } | إرجاع الفقرة الأصلية المباشرة. |
| PreviousSibling { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرة. |
| Range { get; } | إرجاع أRange الكائن الذي يمثل جزء المستند الموجود في هذه العقدة. |
| RelativeHorizontalPosition { get; set; } | يحدد نسبة إلى ما يتم وضعه أفقيًا. |
| RelativeHorizontalSize { get; set; } | الحصول على أو تعيين قيمة الحجم النسبي للشكل في الاتجاه الأفقي. |
| RelativeVerticalPosition { get; set; } | يحدد نسبة إلى موضع الشكل عموديًا. |
| RelativeVerticalSize { get; set; } | الحصول على أو تعيين قيمة الحجم النسبي للشكل في الاتجاه الرأسي. |
| Right { get; } | الحصول على موضع الحافة اليمنى للكتلة التي تحتوي على الشكل. |
| Rotation { get; set; } | تحدد الزاوية (بالدرجات) التي يتم تدوير الشكل بها. القيمة الموجبة تتوافق مع زاوية الدوران في اتجاه عقارب الساعة. |
| ScreenTip { get; set; } | تحديد النص المعروض عندما يتحرك مؤشر الماوس فوق الشكل. |
| ShadowFormat { get; } | الحصول على تنسيق الظل للشكل. |
| ShapeType { get; } | الحصول على نوع الشكل. |
| SizeInPoints { get; } | الحصول على حجم الشكل بالنقاط. |
| Target { get; set; } | الحصول على الإطار المستهدف للارتباط التشعبي للشكل أو تعيينه. |
| Title { get; set; } | الحصول على أو تعيين العنوان (التسمية التوضيحية) لكائن الشكل الحالي. |
| Top { get; set; } | الحصول على أو تعيين موضع الحافة العلوية للكتلة التي تحتوي على الشكل. |
| TopRelative { get; set; } | الحصول على أو تعيين القيمة التي تمثل الموضع العلوي النسبي للشكل بالنسبة المئوية. |
| VerticalAlignment { get; set; } | يحدد كيفية وضع الشكل عموديًا. |
| Width { get; set; } | الحصول على أو تعيين عرض الكتلة التي تحتوي على الشكل. |
| WidthRelative { get; set; } | الحصول على أو تعيين القيمة التي تمثل النسبة المئوية للعرض النسبي للشكل. |
| WrapSide { get; set; } | يحدد كيفية التفاف النص حول الشكل. |
| WrapType { get; set; } | يحدد ما إذا كان الشكل سطريًا أم عائمًا. للأشكال العائمة يحدد وضع الالتفاف للنص حول الشكل. |
| ZOrder { get; set; } | تحديد ترتيب عرض الأشكال المتداخلة. |
طُرق
| اسم | وصف |
|---|---|
| abstract Accept(DocumentVisitor) | يقبل الزائر. |
| AdjustWithEffects(RectangleF) | يضيف إلى قيم المستطيل المصدر لمدى التأثير ويعيد المستطيل النهائي. |
| AppendChild(Node) | إضافة العقدة المحددة إلى نهاية قائمة العقد التابعة لهذه العقدة. |
| Clone(bool) | إنشاء نسخة مكررة من العقدة. |
| CreateNavigator() | إنشاء متصفح يمكن استخدامه لاجتياز العقد وقراءتها. |
| FetchInheritedShapeAttr(int) | محجوز لاستخدام النظام. IShapeAttrSource. |
| FetchShapeAttr(int) | محجوز لاستخدام النظام. IShapeAttrSource. |
| GetAncestor(NodeType) | يحصل على السلف الأول للمحددNodeType . |
| GetAncestor(Type) | الحصول على السلف الأول لنوع الكائن المحدد. |
| GetChild(NodeType, int, bool) | إرجاع العقدة الفرعية N التي تطابق النوع المحدد. |
| GetChildNodes(NodeType, bool) | إرجاع مجموعة مباشرة من العقد الفرعية التي تطابق النوع المحدد. |
| GetDirectShapeAttr(int) | محجوز لاستخدام النظام. IShapeAttrSource. |
| GetEnumerator() | يوفر الدعم لتكرار كل نمط عبر العقد الفرعية لهذه العقدة. |
| GetShapeRenderer() | إنشاء وإرجاع كائن يمكن استخدامه لتحويل هذا الشكل إلى صورة. |
| override GetText() | الحصول على نص هذه العقدة وجميع أبنائها. |
| IndexOf(Node) | إرجاع فهرس العقدة الفرعية المحددة في صفيف العقدة الفرعية. |
| InsertAfter(Node, Node) | يقوم بإدراج العقدة المحددة مباشرة بعد العقدة المرجعية المحددة. |
| InsertBefore(Node, Node) | يقوم بإدراج العقدة المحددة مباشرة قبل العقدة المرجعية المحددة. |
| LocalToParent(PointF) | تحويل قيمة من المساحة الإحداثية المحلية إلى المساحة الإحداثية للشكل الأصلي. |
| NextPreOrder(Node) | الحصول على العقدة التالية وفقًا لخوارزمية اجتياز شجرة الطلب المسبق. |
| PrependChild(Node) | إضافة العقدة المحددة إلى بداية قائمة العقد التابعة لهذه العقدة. |
| PreviousPreOrder(Node) | الحصول على العقدة السابقة وفقًا لخوارزمية اجتياز شجرة الطلب المسبق. |
| Remove() | يزيل نفسه من الأصل. |
| RemoveAllChildren() | إزالة جميع العقد الفرعية للعقدة الحالية. |
| RemoveChild(Node) | إزالة العقدة الفرعية المحددة. |
| RemoveShapeAttr(int) | محجوز لاستخدام النظام. IShapeAttrSource. |
| RemoveSmartTags() | يزيل الكلSmartTagالعقد التابعة للعقدة الحالية. |
| SelectNodes(string) | تحديد قائمة العقد المطابقة لتعبير XPath. |
| SelectSingleNode(string) | تحديد الأولNode الذي يطابق تعبير XPath. |
| SetShapeAttr(int, object) | محجوز لاستخدام النظام. IShapeAttrSource. |
| ToString(SaveFormat) | تصدير محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| ToString(SaveOptions) | تصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
هذه فئة مجردة. الفئتان المشتقتان اللتان يمكنك إنشاء مثيل لهما هماShape وGroupShape.
الشكل عبارة عن عقدة في شجرة المستندات.
إذا كان الشكل طفلاParagraph كائن، ثم يقال أن الشكل هو “المستوى الأعلى”. يتم قياس الأشكال ذات المستوى الأعلى ووضعها في نقاط.
يمكن أن يحدث الشكل أيضًا عندما يكون طفلاً لـGroupShape كائن عند تجميع عدة أشكال . يتم وضع الأشكال الفرعية لشكل المجموعة في مساحة الإحداثيات ويتم تعريف الوحدات بواسطةCoordSize وCoordOrigin خصائص شكل المجموعةparent .
يمكن وضع الشكل سطريًا مع النص أو عائمًا. يتم التحكم في طريقة تحديد المواقع باستخدامWrapType ملكية.
عندما يكون الشكل عائمًا، يتم وضعه بالنسبة لشيء ما (على سبيل المثال، الفقرة الحالية، الهامش أو الصفحة). يتم تحديد الموضع النسبي للشكل باستخدام RelativeHorizontalPosition وRelativeVerticalPosition ملكيات.
يتم وضع الشكل العائم بشكل واضح باستخدامLeft وTop خصائص أو محاذاتها بالنسبة لبعض الكائنات الأخرى باستخدامHorizontalAlignment وVerticalAlignment ملكيات.
أمثلة
يوضح كيفية إدراج صورة عائمة في وسط الصفحة.
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.Drawing
- المجسم Aspose.Words
