إضافة بيانات الشكل واستردادها ونسخها وقراءتها Visio
إضافة شكل جديد في Visio
Aspose.Diagram for .NET يسمح لك بمعالجة Microsoft Visio المخططات بطرق مختلفة. أحد الأشياء التي يمكنك القيام بها هو إضافة أشكال جديدة إلى الرسوم التخطيطية. يتيح لك Aspose.Diagram for .NET إضافة شكل جديد إلى diagram. يمكن أيضًا تخصيص الشكل المضاف باستخدام Aspose.Diagram for .NET.
يصف هذا الموضوع كيفية إضافة شكل مستطيل جديد إلى diagram.
استخدم Aspose.Diagram for .NET API لإنشاء أشكال جديدة ثم قم بإضافة هذه الأشكال إلى مجموعة أشكال diagram.
لإضافة شكل جديد:
- ابحث عن الصفحة - يحتوي كل Visio diagram على مجموعة من الصفحات. يمكن للمطورين استرداد الصفحة حسب معرّف الصفحة أو الاسم وتخزين الصفحة المطلوبة في ملفصفحةكائن فئة.
- أضف المطلوب الرئيسي للشكل - يحتوي كل Visio diagram على مجموعة من الأساتذة. يمكن للمطورين إضافة رئيسي (بواسطة المعرف أو الاسم) من ملف الاستنسل الموجود (عن طريق المسار المباشر أو دفق الملف).
- أضف شكلاً في Visio diagram - يمكن للمطورين وضع شكل جديد في Visio diagram حسب فهرس الصفحة (يبدأ من 0) ، الاسم الرئيسي ، PinX ، PinY ، الارتفاع (اختياري) والعرض (اختياري).
- تعيين خصائص الشكل - تقوم طريقة AddShape للفئة Diagram بإرجاع معرف الشكل. يمكن للمطورين استرداد الشكل من diagram Visio باستخدام هذا المعرف ، ثم تعيين خصائصه ، مثل اللون والموضع والمحاذاة والنص.
المدخلات diagram |
diagram مع إضافة الشكل |
---|
إضافة عينة البرمجة
يوضح مقتطف الشفرة أدناه كيفية القيام بكل خطوة.
استرجاع معلومات الشكل
العمل مع المخططاتيشرح كيفية إنشاء الرسوم البيانية وإضافة الأشكال والموصلات ، ثم كيفية استرداد المعلومات حول عناصر diagram مثلالصفحات, سادة, موصلات والخطوط. تبحث هذه المقالة في كيفية استرداد معلومات حول الأشكال في diagram.
كل شكل في diagram له معرف واسم. المعرف مهم عند البرمجة باستخدام Visio: إنه الطريقة الرئيسية للوصول إلى الشكل. يحتفظ كل شكل أيضًا بمعلومات حول العنصر الرئيسي (الاستنسل) الذي يتكون منه.
أشكل هو كائن في رسم Visio. تدعم خاصية الأشكال ، المكشوفة بواسطة فئة الصفحة ، مجموعة من Aspose.Diagram كائنات الشكل. يمكن استخدام الخاصية الأشكال لاسترداد معلومات حول الشكل.
في نافذة وحدة التحكم أدناه ، على سبيل المثال ، يمكنك مشاهدة إخراج المعلومات لـ diagram الذي يحتوي على أربعة أشكال: محطتي إنهاء وعملية وموصل ديناميكي. لكل منها معرف فريد بالإضافة إلى اسم الشكل الرئيسي (الاستنسل).
نافذة وحدة تحكم تعرض معلومات الشكل |
---|
لاسترداد معلومات الصفحة Visio: |
- يحمل diagram.
- يقوم بإعداد حلقة foreach للتكرار خلال كل الأشكال الموجودة في diagram.
- يعرض معلومات الشكل.
استرجاع عينة البرمجة
تسترد قطعة الكود التالية معلومات الشكل من Visio diagram.
نسخ الأشكال من Visio موجود
Aspose.Diagram for .NET API يسمح للمطورين بنسخ الأشكال من صفحة المصدر Visio إلى صفحة Visio diagram الجديدة. كما يدعم نسخ أشكال المجموعة. توضح هذه المقالة كيفية نسخ كافة الأشكال من الصفحة diagram المصدر.
لنسخ الأشكال ، يجب على المطورين أيضًا نسخ نسق ورقة الصفحة والمصدر Visio المصدر للاحتفاظ بنمط تعبئة الشكل وخصائص التنسيق الأخرى.
هذا المثال يعمل على النحو التالي:
- قم بتحميل المصدر Visio.
- تهيئة Visio جديد
- قم بإضافة الأساسيات والنُسق من المصدر Visio.
- احصل على الصفحة من المصدر Visio.
- انسخ ورقة الصفحة الخاصة بها إلى صفحة Visio الجديدة.
- التكرار من خلال أشكال الصفحة Visio المصدر.
- قم بتعيين معرفه الجديد وأضفه إلى صفحة Visio الجديدة.
- احفظ Visio الجديد في التخزين المحلي.
عينة برمجة نسخ
انسخ شكل Visio إلى مثيل Shape آخر
تأخذ طريقة النسخ الخاصة بفئة الشكل مثيل شكل للنسخ.
// import diagram
Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");
Shape newShape = new Shape();
// copy diagram
newShape.Copy(diagram.Pages[0].Shapes[0]);
newShape.ID = 3;
newShape.XForm.PinX.Value = 1;
newShape.XForm.PinY.Value = 1;
قراءة Visio بيانات الشكل
مجموعة Props التي كشفهاشكل فئة تدعمAspose.Diagram.Prop هدف. يمكن استخدام الخاصية لقراءة بيانات الشكل (الخصائص المخصصة).
قراءة كافة خصائص الشكل
لتحديد الخصائص المخصصة في Microsoft Visio:
- في diagram ، انقر بزر الماوس الأيمن فوق شكل.
- يختاربيانات ، ومن بعدبيانات الشكل من القائمة. يتم سرد أي خصائص موجودة في مربع الحوار.
بيانات الشكل ، كما هو موضح في Microsoft Visio. | ** |
---|---|
نافذة وحدة تحكم تعرض إخراج بيانات الشكل. | ** |
---|---|
قراءة نموذج البرمجة
تقرأ مقتطفات التعليمات البرمجية أدناه بيانات الشكل (الخصائص المخصصة).
اقرأ خاصية الشكل بالاسم
يقرأ مقتطف الشفرة أدناه خاصية الشكل بالاسم (خاصية مخصصة).
تمت قراءتها حسب نموذج برمجة الاسم
اقرأ InheritProps of Shape
يقرأ مقتطف الشفرة أدناه InheritProps لشكل.
إضافة وتوصيل Visio الأشكال
Aspose.Diagram for .NET يسمح لك بإضافة أشكال مخصصة وربطهاالرسوم البيانية التي تقوم بإنشائها.
إضافة وتوصيل الأشكال
يوضح الكود الموجود في العينات أدناه كيفية:
- قم بإنشاء diagram.
- قم بإضافة الأشكال وتخصيصها (مستطيل ، نجمة ، مسدس).
- قم بتوصيل الأشكال النجمية والسداسية بالمستطيل.
- احفظ diagram.
نموذج برمجة إضافة وتوصيل الأشكال
استخدم فهارس الاتصال لتوصيل الأشكال
Aspose.Diagram for .NET API يسمح بالفعل للمطورين بإضافة نقاط اتصال جديدة على الشكل ، ويمكن للمطورين الآن توصيل الأشكال باستخدام فهارس الاتصال.
استخدم فهارس الاتصال لتوصيل الأشكال
يتم عرض عضو ConnectShapesViaConnectorIndex بواسطة ملفصفحةيمكن استخدام class لتوصيل الأشكال باستخدام فهارس الاتصال. يوضح الكود التالي كيفية توصيل الأشكال:
- تهيئة رسم جديد.
- ضع أربعة أشكال مستطيلة
- أضف نقطتي اتصال إضافيتين ، بحيث يكون هناك ثلاث نقاط اتصال على خط الحد السفلي
- قم بتوصيل الشكل الأول من كل اتصال سفلي بأشكال المستطيلات الثلاثة الأخرى من الأعلى باستخدام الموصلات الديناميكية
- حفظ الرسم
استخدم فهارس الاتصال لتوصيل الأشكال عينة البرمجة
استخدم الكود التالي في تطبيق .NET الخاص بك لتوصيل الأشكال باستخدام فهارس الاتصال مع Aspose.Diagram for .NET API.
C#
// initialize a new drawing
Diagram diagram = new Diagram();
// get page by index
Aspose.Diagram.Page page = diagram.Pages[0];
// add masters
string connectorMaster = "Dynamic connector", rectangle = "Rectangle";
int pageNumber = 0;
double width = 2, height = 2, pinX = 4.25, pinY = 9.5;
diagram.AddMaster(@"C:\temp\Basic Shapes.vss", rectangle);
diagram.AddMaster(@"C:\temp\Basic Shapes.vss", connectorMaster);
// add shapes
long shape1_ID = diagram.AddShape(4.5, 7, rectangle, pageNumber);
long shape2_ID = diagram.AddShape(2.25, 4.5, rectangle, pageNumber);
long shape3_ID = diagram.AddShape(4.5, 4.5, rectangle, pageNumber);
long shape4_ID = diagram.AddShape(6.75, 4.5, rectangle, pageNumber);
// get shapes by ID
Aspose.Diagram.Shape shape1 = page.Shapes.GetShape(shape1_ID);
Aspose.Diagram.Shape shape2 = page.Shapes.GetShape(shape2_ID);
Aspose.Diagram.Shape shape3 = page.Shapes.GetShape(shape3_ID);
Aspose.Diagram.Shape shape4 = page.Shapes.GetShape(shape4_ID);
// add two more connection points
Connection connection1 = new Connection();
connection1.X.Ufe.F = "Width*0.33";
connection1.Y.Ufe.F = "Height*0";
Connection connection3 = new Connection();
connection3.X.Ufe.F = "Width*0.66";
connection3.Y.Ufe.F = "Height*0";
shape1.Connections.Add(connection1);
shape1.Connections.Add(connection3);
// add connector shapes
Aspose.Diagram.Shape connector1 = new Aspose.Diagram.Shape();
Aspose.Diagram.Shape connector2 = new Aspose.Diagram.Shape();
Aspose.Diagram.Shape connector3 = new Aspose.Diagram.Shape();
long connecter1Id = diagram.AddShape(connector1, connectorMaster, 0);
long connecter2Id = diagram.AddShape(connector2, connectorMaster, 0);
long connecter3Id = diagram.AddShape(connector3, connectorMaster, 0);
// connect shapes by index of conneecting points
page.ConnectShapesViaConnectorIndex(shape1.ID, 6, shape2.ID, 3, connecter1Id);
page.ConnectShapesViaConnectorIndex(shape1.ID, 1, shape3.ID, 3, connecter2Id);
page.ConnectShapesViaConnectorIndex(shape1.ID, 7, shape4.ID, 3, connecter3Id);
// save drawing
diagram.Save(@"C:\temp\Drawing1_out.vsdx", SaveFileFormat.VSDX);
استرجع الشكل الأصلي لشكل فرعي
Aspose.Diagram for .NET يسمح للمطورين باسترجاع الشكل الرئيسي لشكل فرعي.
احصل على شكل الوالدين
الشكلتقدم الفئة خاصية ParentShape لاسترداد الشكل الأصل.