MS Visio هو تطبيق شائع يتيح لك إنشاء مجموعة كبيرة من الرسوم التخطيطية مثل المخططات الانسيابية ومخططات تدفق البيانات ونماذج العمليات التجارية وما إلى ذلك. VSDX هو تنسيق الملف الذي يستخدمه MS Visio لتخزين المخططات. من أجل أتمتة معالجة VSDX ، توفر لك هذه المقالة برنامجًا تعليميًا أساسيًا حول كيفية إنشاء مخططات Visio من البداية في C#. علاوة على ذلك ، فإنه يغطي كيفية إدراج الصفحات والأشكال والنص في الرسوم البيانية VSDX من داخل تطبيقات .NET.

C# Visio API - تنزيل مجاني

Aspose.Diagram for .NET عبارة عن واجهة برمجة تطبيقات غنية بالميزات تتيح لك إنشاء وتحرير وتحويل ومعالجة الرسوم البيانية MS Visio من داخل تطبيقات .NET الخاصة بك. تسهل واجهة برمجة التطبيقات (API) معالجة مخططات VSDX بخصائص وطرق سهلة الاستخدام. يمكنك إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيتها داخل تطبيقات .NET باستخدام NuGet.

Install-Package Aspose.Diagram

إنشاء رسم تخطيطي Visio VSDX باستخدام C#

بادئ ذي بدء ، لنقم بإنشاء رسم تخطيطي VSDX فارغ من البداية. فيما يلي خطوات القيام بذلك:

يُظهر نموذج التعليمات البرمجية التالي كيفية إنشاء الرسم التخطيطي Visio VSDX في C#.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Diagrams();

// قم بإنشاء دليل إذا لم يكن موجودًا بالفعل.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
// تهيئة Visio جديد
Diagram diagram = new Diagram();
dataDir = dataDir + "CreateDiagram_out.vsdx";
// احفظ بتنسيق VSDX
diagram.Save(dataDir, SaveFileFormat.VSDX);

أضافه رئيسي إلى الرسم التخطيطي لـ Visio في C#

يستخدم Master لإضافة الاستنسل الذي يحتوي على مجموعة من الأشكال لاستخدامها في الرسوم التخطيطية. إذا كنت ترغب في إضافة المعلم ، فأنت بحاجة إلى ملف استنسل VSS ومعرف رئيسي. فيما يلي الخطوات لإضافة رئيسي إلى الرسم التخطيطي في Visio باستخدام Aspose.Diagram.

يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة شريحة رئيسية إلى الرسم التخطيطي لـ Visio باستخدام C#.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Master();

// رسم تخطيطي للتحميل
Diagram diagram = new Diagram();

// تحميل الاستنسل إلى تيار
string templateFileName = dataDir + "NetApp-FAS-series.vss";
Stream stream = new FileStream(templateFileName, FileMode.Open);

// إضافة رئيسي مع مسار ملف الاستنسل والمعرف الرئيسي
string masterName = "FAS80xx rear empty";
diagram.AddMaster(templateFileName, 2);

// إضافة رئيسي مع مسار ملف الاستنسل والاسم الرئيسي
diagram.AddMaster(templateFileName, masterName);

// إضافة سيد مع دفق ملف الاستنسل والمعرف الرئيسي
diagram.AddMaster(stream, 2);

// يضيف رئيسي إلى الرسم التخطيطي من الرسم التخطيطي المصدر
Diagram src = new Diagram(templateFileName);
diagram.AddMaster(src, masterName);

// إضافة سيد مع دفق ملف الاستنسل والمعرف الرئيسي
diagram.AddMaster(stream, masterName);

// يضيف الشكل مع تعريف PinX و PinY.
diagram.AddShape(2.0, 2.0, masterName, 0);
diagram.AddShape(6.0, 6.0, masterName, 0);

// يضيف الشكل مع تعريف PinX و PinY والعرض والارتفاع.
diagram.AddShape(7.0, 3.0, 1.5, 1.5, masterName, 0);

لمزيد من التفاصيل ، يرجى زيارة working with master.

إدراج صفحات في رسم تخطيطي لـ Visio في C#

تتكون مخططات MS Visio من صفحة واحدة أو أكثر وتحتوي كل صفحة على الرسوم التخطيطية. لذلك ، قبل إضافة شكل ، تحتاج إلى إضافة صفحة باتباع الخطوات التالية.

  • أنشئ رسمًا تخطيطيًا جديدًا أو قم بتحميل رسم تخطيطي موجود باستخدام فئة الرسم التخطيطي.
  • تحقق مما إذا كان الرسم التخطيطي يحتوي بالفعل على صفحة باستخدام خاصية Diagram.Pages.Count.
  • إذا حدث ذلك ، فاحصل على معرف الصفحة الأخيرة باستخدام خاصية Diagram.Pages[index] .ID.
  • قم بإنشاء صفحة جديدة باستخدام فئة صفحة وقم بتعيين اسمها ومعرفها.
  • أضف صفحة إلى الرسم التخطيطي باستخدام طريقة Diagram.Pages.Add (Page).
  • احفظ مخطط VSDX باستخدام طريقة Diagram.Save (Sring fileName، SaveFileFormat.VSDX).

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة صفحة في الرسم التخطيطي Visio VSDX باستخدام C#.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_VisioPages();

// رسم تخطيطي للتحميل
Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");

// يحسب معرف الصفحة القصوى
int max = 0;
if (diagram.Pages.Count != 0)
    max = diagram.Pages[0].ID;

for (int i = 1; i < diagram.Pages.Count; i++)
{
    if (max < diagram.Pages[i].ID)
        max = diagram.Pages[i].ID;
}

// تعيين معرف الصفحة القصوى
int MaxPageId = max;

// تهيئة كائن صفحة جديد
Page newPage = new Page();
// اسم مجموعة
newPage.Name = "new page";
// تعيين معرف الصفحة
newPage.ID = MaxPageId + 1;

// أو جرب مُنشئ الصفحة
// صفحة newPage = صفحة جديدة (MaxPageId + 1) ؛

// أضف صفحة فارغة جديدة
diagram.Pages.Add(newPage);

// حفظ الرسم التخطيطي
diagram.Save(dataDir + "InsertBlankPage_out.vsdx", SaveFileFormat.VSDX);

لمزيد من التفاصيل ، يرجى زيارة العمل مع الصفحات.

إنشاء شكل في رسم Visio التخطيطي باستخدام C#

الأشكال هي الكتل الإنشائية لرسومات Visio التخطيطية. يدعم MS Visio مجموعة كبيرة من الأشكال لإنشاء مخططات في مجالات مختلفة. توضح الخطوات التالية كيفية إدراج شكل في رسم Visio التخطيطي.

يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة شكل في الرسم التخطيطي لـ Visio باستخدام C#.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_Shapes();

// قم بتحميل رسم تخطيطي
Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");
// احصل على الصفحة بالاسم
Page page = diagram.Pages.GetPage("Page-2");

// إضافة رئيسي مع مسار ملف الاستنسل والاسم الرئيسي
string masterName = "Rectangle";
diagram.AddMaster(dataDir + "Basic Shapes.vss", masterName);
            
// تبدأ فهرسة الصفحة من 0
int PageIndex = 1;
double width = 2, height = 2, pinX = 4.25, pinY = 4.5;
// أضف شكل مستطيل جديد
long rectangleId = diagram.AddShape(pinX, pinY, width, height, masterName, PageIndex);
            
// تعيين خصائص الشكل 
Shape rectangle = page.Shapes.GetShape(rectangleId);
rectangle.XForm.PinX.Value = 5;
rectangle.XForm.PinY.Value = 5;
rectangle.Type = TypeValue.Shape;
rectangle.Text.Value.Add(new Txt("Aspose Diagram"));
rectangle.TextStyle = diagram.StyleSheets[3];
rectangle.Line.LineColor.Value = "#ff0000";
rectangle.Line.LineWeight.Value = 0.03;
rectangle.Line.Rounding.Value = 0.1;
rectangle.Fill.FillBkgnd.Value = "#ff00ff";
rectangle.Fill.FillForegnd.Value = "#ebf8df";

diagram.Save(dataDir + "AddShape_out.vsdx", SaveFileFormat.VSDX);
Console.WriteLine("Shape has been added.");

لمزيد من التفاصيل ، يرجى زيارة العمل مع الأشكال.

أضافه شكل نص في صفحة Visio في C#

في حالات مختلفة ، تحتاج أيضًا إلى إضافة نص إلى مخططات Visio التخطيطية. لهذا ، يمكنك اتباع الخطوات أدناه.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص في مخطط VSDX باستخدام C#.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_ShapeText();

// قم بإنشاء رسم تخطيطي جديد
Diagram diagram = new Diagram();
// قم بتعيين المعلمات وإضافة نص إلى صفحة Visio
double PinX = 1, PinY = 1, Width = 1, Height = 1;                  
diagram.Pages[0].AddText(PinX, PinY, Width, Height, "Test text");
// حفظ الرسم التخطيطي 
diagram.Save(dataDir + "InsertTextShape_out.vsdx", SaveFileFormat.VSDX);

لمزيد من التفاصيل ، يرجى زيارة working with text.

استنتاج

في هذا المنشور ، تعلمت بعض الميزات الأساسية لبرنامج Aspose.Diagram لـ .NET لإنشاء مخططات Visio VSDX من البداية. أظهرت عينات التعليمات البرمجية كيفية إضافة الشرائح الرئيسية والصفحات والأشكال والنص في الرسوم البيانية VSDX باستخدام C#. يمكنك استكشاف المزيد حول API باستخدام التوثيق.

أنظر أيضا