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

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

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

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

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

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

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

Install-Package Aspose.Words

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

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

DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

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

headerImage.Width = 1 * 72; // يساوي بوصة واحدة
headerImage.Height = 1 * 72;

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

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

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

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

            
// تحميل مستند Word DOC الذي تريد إضافة الصور إليه
Document addImagesToWordDOC = new Document("input.doc");

// إنشاء كائن من فئة DocumentBuilder لكتابة النصوص والصور والجداول، إلخ.
DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

// نقل المؤشر إلى الرأس الأساسي في مستند Word DOC
imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

// إدراج صورة في رأس مستند Word
Shape headerImage = imageWriter.InsertImage("path-to-header-image.jpeg");

// تعيين حجم الصورة في الرأس
headerImage.Width = 1 * 72; // يساوي بوصة واحدة
headerImage.Height = 1 * 72;

// نقل المؤشر إلى آخر فقرة في مستند Word
imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);

// إضافة صورة إلى مستند Word ورابط إلى ملف
Shape imageAsLinkToFile = imageWriter.InsertImage("path-to-image.jpeg");
imageAsLinkToFile.ImageData.SourceFullName = "path-to-image.jpeg"
// حفظ كـ DOCX
addImagesToWordDOC.Save("images.docx");

الخاتمة

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