إدراج الصور والأشكال في ملفات إكسيل.

في بعض الأحيان قد تحتاج إلى إدراج بعض الأشكال الضرورية في ورقة العمل. قد تحتاج إلى إدراج نفس الشكل في مواقع مختلفة في ورقة العمل. أو قد تحتاج إلى إدراج أشكال بشكل دُفعي في ورقة العمل.

لا تقلق! Aspose.Cells تدعم جميع هذه العمليات.

الأشكال في إكسل تنقسم أساسًا إلى الأنواع التالية:

• الصور
• الكائنات OLE
• الخطوط
• المستطيلات
• الأشكال الأساسية
• السهام البلوكية
• أشكال المعادلة
• رسوم بيانية لسير العمل
• النجوم والرايات
• التلويحات

سيتم في هذا الدليل اختيار شكل أو اثنين من كل نوع لإنشاء أمثلة. من خلال هذه الأمثلة، ستتعلم كيفية استخدام Aspose.Cells لإدراج الشكل المحدد في ورقة العمل.

إضافة الصور في ورقة عمل إكسل في س#

إضافة الصور إلى جدول بيانات سهل للغاية. يستغرق الأمر سوى بضعة أسطر من الكود: اتصل ببساطة بالطريقة Add لمجموعة Pictures، المغلفة في كائن Worksheet. تأخذ الطريقة Add المعاملات التالية:

• فهرس الصف الأعلى الأيسر، فهرس الصف الأعلى.
• فهرس العمود الأعلى الأيسر، فهرس العمود الأعلى.
• اسم ملف الصورة، اسم ملف الصورة، مع المسار الكامل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a new worksheet to the Workbook object
int sheetIndex = workbook.Worksheets.Add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
Worksheet worksheet = workbook.Worksheets[sheetIndex];

// Adding a picture at the location of a cell whose row and column indices
// Are 5 in the worksheet. It is "F6" cell
worksheet.Pictures.Add(5, 5, dataDir + "logo.jpg");

// Saving the Excel file
workbook.Save(dataDir + "output.xls");

إدراج كائنات OLE في ورقة العمل إكسل في س#

تدعم Aspose.Cells إضافة واستخراج وتلاعب بكائنات OLE في الأوراق العمل. لهذا السبب، لديها Aspose.Cells OleObjectCollection الفئة التي تُستخدم لإضافة كائن OLE جديد إلى قائمة المجموعة. فئة أُخرى، OleObject، تمثل كائن OLE. لها بعض الأعضاء المهمة:

• تحدد الخاصية ImageData بيانات الصورة (الرمز) من نوع مصفوفة بايت. سيتم عرض الصورة لعرض كائن OLE في ورقة العمل.
• تحدد الخاصية ObjectData بيانات الكائن بشكل مصفوفة بايت. سيتم عرض هذه البيانات في البرنامج المرتبط بها عند النقر المزدوج على أيقونة كائن OLE.

المثال التالي يوضح كيفية إضافة كائنات OLE إلى ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiate a new Workbook.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet sheet = workbook.Worksheets[0];

// Define a string variable to store the image path.
string ImageUrl = dataDir + "logo.jpg";

// Get the picture into the streams.
FileStream fs = File.OpenRead(ImageUrl);

// Define a byte array.
byte[] imageData = new Byte[fs.Length];

// Obtain the picture into the array of bytes from streams.
fs.Read(imageData, 0, imageData.Length);

// Close the stream.
fs.Close();

// Get an excel file path in a variable.
string path = dataDir + "book1.xls";

// Get the file into the streams.
fs = File.OpenRead(path);

// Define an array of bytes.
byte[] objectData = new Byte[fs.Length];

// Store the file from streams.
fs.Read(objectData, 0, objectData.Length);

// Close the stream.
fs.Close();

// Add an Ole object into the worksheet with the image
// Shown in MS Excel.
sheet.OleObjects.Add(14, 3, 200, 220, imageData);

// Set embedded ole object data.
sheet.OleObjects[0].ObjectData = objectData;

// Save the excel file
workbook.Save(dataDir + "output.out.xls");

إدراج خط في ورقة Excel في C#

شكل الخط ينتمي إلى فئة الخطوط.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج الخط فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد الخط من ‘الأشكال المستخدمة مؤخرًا’ أو ‘الخطوط’.

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج خط في ورقة العمل.

public LineShape AddLine(int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تُرجع الطريقة كائن LineShape.

يظهر المثال التالي كيفية إدراج خط في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the line to the worksheet
sheet.Shapes.AddLine(2, 0, 2, 0, 100, 300);//method 1
//sheet.Shapes.AddAutoShape(AutoShapeType.Line, 2, 0, 2, 0, 100, 300);//method 2
//sheet.Shapes.AddShape(MsoDrawingType.Line, 2, 0, 2, 0, 100, 300);//method 3

//Save.You can check your line in this way.
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج سهم خط في ورقة Excel في C#

شكل سهم الخط ينتمي إلى فئة الخطوط. إنه حالة خاصة من الخط.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج سهم الخط فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد سهم الخط من ‘الأشكال المستخدمة مؤخرًا’ أو ‘الخطوط’.

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج سهم خط في ورقة العمل.

public LineShape AddLine(int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تُرجع الطريقة كائن LineShape.

المثال التالي يوضح كيفية إدراج سهم خط في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the line arrow to the worksheet
Shape s = sheet.Shapes.AddLine(2, 0, 2, 0, 100, 300);//method 1
//Shape s = sheet.Shapes.AddAutoShape(AutoShapeType.Line, 2, 0, 2, 0, 100, 300);//method 2
//Shape s = sheet.Shapes.AddShape(MsoDrawingType.Line, 2, 0, 2, 0, 100, 300);//method 3

//add a arrow at the line begin
s.Line.BeginArrowheadStyle = MsoArrowheadStyle.Arrow;//arrow type
s.Line.BeginArrowheadWidth = MsoArrowheadWidth.Wide;//arrow width
s.Line.BeginArrowheadLength = MsoArrowheadLength.Short;//arrow length

//add a arrow at the line end
s.Line.EndArrowheadStyle = MsoArrowheadStyle.ArrowOpen;//arrow type
s.Line.EndArrowheadWidth = MsoArrowheadWidth.Narrow;//arrow width
s.Line.EndArrowheadLength = MsoArrowheadLength.Long;//arrow length
            
//Save.You can check your arrow in this way.
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج مستطيل في ورقة العمل Excel باستخدام C#

شكل المستطيل ينتمي إلى فئة المستطيلات.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج المستطيل فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم اختر المستطيل من ‘الأشكال المستخدمة مؤخرًا’ أو ‘المستطيلات’

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج مستطيل في ورقة العمل.

public RectangleShape AddRectangle(int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن RectangleShape.

المثال التالي يوضح كيفية إدراج مستطيل في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the rectangle to the worksheet
sheet.Shapes.AddRectangle(2, 0, 2, 0, 100, 300);

//Save
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج مكعب في ورقة العمل في Excel باستخدام C#

شكل المكعب ينتمي إلى فئة الأشكال الأساسية.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج المكعب فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد المكعب من الأشكال الأساسية

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج مكعب في الورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

المثال التالي يوضح كيفية إدراج مكعب في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the cube to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.Cube, 2, 0, 2, 0, 100, 300);

//Save.You can check your cube in this way.
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج سهم رباعي القطب إلى ورقة العمل في Excel باستخدام C#

شكل سهم مربعي الدعوة ينتمي إلى فئة السهام الكتلية.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج سهم المربعي الدعوة فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد سهم المربعي الدعوة من السهام الكتلية

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج سهم رباعي الاتصال في ورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

المثال التالي يُظهر كيفية إدراج سهم رباعي الاتصال في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the callout quad arrow to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.QuadArrowCallout, 2, 0, 2, 0, 100, 100);

//Save
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج علامة الضرب في ورقة عمل Excel في C#

شكل علامة الضرب ينتمي إلى فئة أشكال المعادلة.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي ترغب في إدراج علامة الضرب فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد علامة الضرب من أشكال المعادلة

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج علامة الضرب في ورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

المثال التالي يُظهر كيفية إدراج علامة الضرب في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the multiplication sign to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.MathMultiply, 2, 0, 2, 0, 100, 100);

//Save.You can check your multiplication in this way.
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج وثيقة متعددة في ورقة Excel بلغة C#

شكل مستند متعدد الوثائق ينتمي إلى فئة الرسوم البيانية للتدفقات.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي ترغب في إدراج مستند متعدد الوثائق فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم اختر مستند متعدد الوثائق من الرسوم البيانية للتدفقات

استخدام Aspose.Cells

يمكنك استخدام الطريقة التالية لإدراج مستند متعدد الوثائق في ورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

المثال التالي يوضح كيفية إدراج مستند متعدد الوثائق في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the multidocument to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.FlowChartMultidocument, 2, 0, 2, 0, 100, 100);

//Save
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج نجمة خماسية إلى ورقة العمل في Excel باستخدام C#

شكل النجمة المؤلفة من خمس نقاط ينتمي إلى فئة النجوم والرايات.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي ترغب في إدراج النجمة المؤلفة من خمس نقاط فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم اختر النجمة المؤلفة من خمس نقاط من النجوم والرايات

استخدام Aspose.Cells

يمكنك استخدام الأسلوب التالي لإدراج نجمة ذات خمس نقاط في ورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

توضح النموذج التالي كيفية إدراج نجمة ذات خمس نقاط في ورق عمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the Five-pointed star to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.Star5, 2, 0, 2, 0, 100, 100);

//Save.You can check your icon in this way.
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

إدراج سحابة فكرية إلى ورقة العمل في Excel باستخدام C#

شكل سحابة الفكر ينتمي إلى فئة المكالمات.

في Microsoft Excel (على سبيل المثال 2007):

• حدد الخلية التي تريد إدراج سحابة الفكر فيها
• انقر فوق القائمة إدراج وانقر فوق الأشكال.
• ثم، حدد سحابة الفكر من المكالمات

استخدام Aspose.Cells

يمكنك استخدام الأسلوب التالي لإدراج سحابة فكرية في ورقة العمل.

public Shape AddAutoShape(AutoShapeType type, int upperLeftRow, int top, int upperLeftColumn, int left, int height, int width)

تعيد الطريقة كائن Shape.

المثال التالي يوضح كيفية إدراج سحابة فكرية في ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Create workbook from sample file
Workbook workbook = new Workbook();

// Access first worksheet from the collection
Worksheet sheet = workbook.Worksheets[0];

// Add the thought bubble cloud to the worksheet
sheet.Shapes.AddAutoShape(AutoShapeType.CloudCallout, 2, 0, 2, 0, 100, 100);

//Save
workbook.Save("sample.xlsx", SaveFormat.Xlsx);

قم بتنفيذ الكود أعلاه، ستحصل على النتائج التالية:

مواضيع متقدمة

• تغيير قيم التعديل للشكل
• نسخ الأشكال بين أوراق العمل
• البيانات في شكل غير مبدل
• العثور على الموضع المطلق للشكل داخل الورقة العمل
• الحصول على نقاط الاتصال من الشكل
• إدارة الضوابط
• إضافة رموز إلى ورقة العمل
• إدارة كائنات OLE
• إدارة الصور
• إدارة الذكاء الفني
• إدارة مربع النص
• إضافة كلمة WaterArt كعلامة مائية إلى ورقة العمل
• تحديث القيم للأشكال المرتبطة
• إرسال الشكل إلى الأمام أو الوراء داخل ورقة العمل
• إدارة خيارات الشكل
• إدارة خيارات نص الشكل
• ملحقات الويب - إضافات الأوفيس