كيفية إضافة صورة في مستند Word باستخدام C#

كيفية إضافة صورة في مستند Word باستخدام C#

سيوجهك هذا الدرس خطوة بخطوة حول كيفية إضافة صور إلى مستند Word باستخدام C#. سنستخدم تطبيق سطر الأوامر لتوضيح إضافة صورة إلى مستند Word.

فوائد إضافة صور إلى مستندات Word

  1. جاذبية بصرية محسّنة:
  • يمكن للصور جعل المستندات أكثر جاذبية.
  1. تحسين التواصل:
  • يمكن للصور أن تساعد في نقل المعلومات المعقدة بوضوح أكبر.
  1. عرض احترافي:
  • يمكن للصور أن تعزز احترافية مستنداتك.

المتطلبات المسبقة: إعداد البيئة

  1. احرص على تثبيت Visual Studio أو أي .NET IDE.
  2. تأكد من أن مكتبة Aspose.Words متاحة عبر NuGet.
  3. احصل على إمكانية الوصول إلى ملف صورة لأغراض العرض.

دليل خطوة بخطوة لإضافة صورة في مستند Word

الخطوة 1: إضافة مرجع إلى System.Drawing

تأكد من أن تجميع System.Drawing مُشار إليه في الحل الخاص بك.

الخطوة 2: إضافة حزمة Aspose.Words NuGet

قم بتثبيت مكتبة Aspose.Words باستخدام مدير الحزم NuGet.

Install-Package Aspose.Words

الخطوة 3: تضمين توجيهات Using

أضف توجيهات using اللازمة في أعلى ملفك.

using Aspose.Words;
using Aspose.Words.Drawing;

الخطوة 4: إنشاء كائن Document

حمّل Word target="_blank" rel="noopener"> DOC

الملف إلى كائن Document.

Document addImagesToWordDOC = new Document("input.doc");

الخطوة 5: إنشاء كائن DocumentBuilder

إنشاء مثيل لفئة DocumentBuilder لتسهيل الكتابة إلى المستند.

DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

الخطوة 6: نقل المؤشر إلى الترويسة

وضع المؤشر في الترويسة الأساسية لمستند Word.

imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

الخطوة 7: إدراج صورة في الترويسة

إدراج صورة في ترويسة مستند Word.

Shape headerImage = imageWriter.InsertImage("C:\\Add Image in Word Header.jpg");

الخطوة 8: تعيين خصائص الصورة

ضبط حجم وموقع الصورة المُدرَجة.

headerImage.Width = 1 * 72; // equals one inch
headerImage.Height = 1 * 72;

الخطوة 9: إضافة صورة كملف مرتبط

انقل المؤشر إلى الفقرة الأخيرة وأضف صورة كارتباط إلى ملف.

using Aspose.Words;
using Aspose.Words.Drawing;
using System.IO;

Document addImagesToWordDOC = new Document();
DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);
imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);
Shape imageAsLinkToFile = imageWriter.InsertImage("Add Image as Link to File.jpg");
imageAsLinkToFile.ImageData.SourceFullName = "Add Image as Link to File.jpg";

الخطوة 10: حفظ المستند

أخيرًا، احفظ مستند Word المعدل على القرص.

addImagesToWordDOC.Save("C:\\Word with Embedded and Linked Images.docx");

مثال على الكود لإضافة صور في مستند Word

إليك مثالًا كاملاً يتضمن جميع الخطوات المذكورة:

using System;
using Aspose.Words;
using Aspose.Words.Drawing;

class Program
{
    static void Main()
    {
        // Load or create a Word document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

        // Insert an image
        string imagePath = "image.png";
        builder.InsertImage(imagePath, RelativeHorizontalPosition.Margin, 0, RelativeVerticalPosition.Margin, 0, 200, 100, WrapType.Square);

        // Save the document
        doc.Save("DocumentWithImage.docx");
        Console.WriteLine("Image embedded successfully.");
    }
}

الخلاصة

لقد أظهر لك هذا البرنامج التعليمي كيفية إضافة صور إلى مستند Word باستخدام C#. باتباع هذه الخطوات، يمكنك تضمين كل من الصور المدمجة والمرتبطة، مما يعزز الجودة الجمالية والمعلوماتية لمستندات Word الخاصة بك. للمزيد من الاستكشاف، فكر في إنشاء مستندات Word برمجيًا بدلاً من الاعتماد على الملفات الموجودة.

 عربي