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; } | يوفر الوصول إلى تنسيق الخط لهذا الكائن. |
| Glow { get; } | يحصل على تنسيق التوهج للشكل. |
| HasChildNodes { get; } | إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية. |
| Height { get; set; } | يحصل على ارتفاع الكتلة التي تحتوي على الشكل أو يعينه. |
| HeightRelative { get; set; } | يحصل على القيمة التي تمثل النسبة المئوية للارتفاع النسبي للشكل أو يعينها. |
| Hidden { 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; } | يحصل على MarkupLanguage المستخدم لهذا الكائن الرسومي. |
| Name { get; set; } | يحصل على اسم الشكل الاختياري أو يعينه. |
| NextSibling { get; } | يحصل على العقدة التي تلي هذه العقدة مباشرة. |
| abstract NodeType { get; } | يحصل على نوع هذه العقدة. |
| ParentNode { get; } | يحصل على الوالد المباشر لهذه العقدة. |
| ParentParagraph { get; } | إرجاع الفقرة الأصلية المباشرة. |
| PreviousSibling { get; } | يحصل على العقدة التي تسبق هذه العقدة مباشرةً. |
| Range { get; } | يعيدRangeالكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة. |
| Reflection { get; } | يحصل على تنسيق الانعكاس للشكل. |
| 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; } | يحصل على حجم الشكل بالنقاط. |
| SoftEdge { 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) | يقبل زائرًا. |
| abstract AcceptEnd(DocumentVisitor) | عند تنفيذه في فئة مشتقة، يتم استدعاء طريقة VisitXXXEnd للزائر المستند المحدد. |
| abstract AcceptStart(DocumentVisitor) | عند تنفيذه في فئة مشتقة، يتم استدعاء طريقة VisitXXXStart للزائر المستند المحدد. |
| AdjustWithEffects(RectangleF) | يضيف إلى قيم المستطيل المصدر لمدى التأثير ويعيد المستطيل النهائي. |
| AppendChild<T>(T) | يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة. |
| Clone(bool) | ينشئ نسخة مكررة من العقدة. |
| CreateNavigator() | ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها. |
| GetAncestor(NodeType) | يحصل على السلف الأول للعنصر المحددNodeType . |
| GetAncestor(Type) | يحصل على السلف الأول لنوع الكائن المحدد. |
| GetChild(NodeType, int, bool) | يعيد عقدة فرعية رقم N تطابق النوع المحدد. |
| GetChildNodes(NodeType, bool) | يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد. |
| GetEnumerator() | يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة. |
| GetShapeRenderer() | ينشئ ويعيد كائنًا يمكن استخدامه لتحويل هذا الشكل إلى صورة. |
| override GetText() | يحصل على نص هذه العقدة وجميع أبنائها. |
| IndexOf(Node) | يعيد مؤشر العقدة الفرعية المحددة في مجموعة العقد الفرعية. |
| InsertAfter<T>(T, Node) | يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة. |
| InsertBefore<T>(T, Node) | يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة. |
| LocalToParent(PointF) | يحول قيمة من مساحة الإحداثيات المحلية إلى مساحة الإحداثيات للشكل الأصلي. |
| NextPreOrder(Node) | يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| PrependChild<T>(T) | يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة. |
| PreviousPreOrder(Node) | يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق. |
| Remove() | يزيل نفسه من الأصل. |
| RemoveAllChildren() | يزيل جميع العقد الفرعية للعقدة الحالية. |
| RemoveChild<T>(T) | يزيل العقدة الفرعية المحددة. |
| RemoveSmartTags() | يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية. |
| SelectNodes(string) | يحدد قائمة العقد المطابقة لتعبير XPath. |
| SelectSingleNode(string) | يحدد الأولNode الذي يتطابق مع تعبير XPath. |
| ToString(SaveFormat) | يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد. |
| ToString(SaveOptions) | يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة. |
ملاحظات
هذه فئة مجردة. الفئتان المشتقتان اللتان يمكنك إنشاء مثيل لهما هماShape وGroupShape.
الشكل هو عقدة في شجرة المستند.
إذا كان الشكل طفلاً لـParagraph إذا كان الكائن عبارة عن “مستوى أعلى”، فيُقال عن الشكل أنه “مستوى أعلى”. يتم قياس الأشكال ذات المستوى الأعلى وتحديد موضعها في نقاط.
يمكن أن يحدث الشكل أيضًا كطفل لـGroupShape الكائن عند تجميع عدة أشكال x000d_. تُوضع الأشكال الفرعية لشكل المجموعة في مساحة الإحداثيات، وتُحدد الوحدات x000d_ بواسطةCoordSize وCoordOrigin خصائص شكل المجموعة parent .
يمكن وضع الشكل ضمن النص أو عائمًا. يتم التحكم في طريقة الوضع باستخدامWrapType ملكية.
عندما يكون الشكل عائمًا، يُحدَّد موضعه بالنسبة لشيء ما (مثل الفقرة الحالية، أو الهامش، أو الصفحة). يُحدَّد الموضع النسبي للشكل باستخدام الدالة x000d.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
