چگونه تصویر را در سند Word با استفاده از C# اضافه کنیم

چگونه تصویر را در سند Word با استفاده از C# اضافه کنیم

این آموزش شما را مرحله به مرحله راهنمایی می‌کند تا چگونه تصاویر را با استفاده از C# به یک سند Word اضافه کنید. ما از یک برنامه خط فرمان برای نمایش افزودن یک تصویر به یک سند Word استفاده خواهیم کرد.

مزایای افزودن تصاویر به اسناد Word

  1. جذابیت بصری بیشتر:
    • تصاویر می‌توانند اسناد را جذاب‌تر کنند.
  2. ارتقای ارتباطات:
    • تصاویر می‌توانند به انتقال اطلاعات پیچیده کمک کنند.
  3. ارائه حرفه‌ای:
    • شامل کردن تصاویر می‌تواند حرفه‌ای بودن اسناد شما را افزایش دهد.

پیش‌نیازها: آماده‌سازی محیط

  1. Visual Studio یا هر IDE .NET دیگری را نصب کرده باشید.
  2. اطمینان حاصل کنید که کتابخانه Aspose.Words از طریق NuGet در دسترس است.
  3. به یک فایل تصویر برای مقاصد نمایشی دسترسی داشته باشید.

راهنمای گام به گام برای افزودن یک تصویر در یک سند Word

مرحله 1: افزودن مرجع به System.Drawing

اطمینان حاصل کنید که اسمبلی System.Drawing در راه‌حل شما ارجاع داده شده است.

مرحله 2: افزودن بسته NuGet Aspose.Words

کتابخانه Aspose.Words را با استفاده از مدیر بسته NuGet نصب کنید.

Install-Package Aspose.Words

مرحله 3: شامل کردن دستورهای Using

دستورهای using لازم را در بالای فایل خود اضافه کنید.

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

مرحله 4: ایجاد شیء Document

فایل DOC Word را در یک شیء 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; // برابر با یک اینچ
headerImage.Height = 1 * 72;

مرحله 9: افزودن تصویر به عنوان یک فایل لینک‌شده

مکان‌نما را به پاراگراف آخر منتقل کرده و یک تصویر را به عنوان لینک به یک فایل اضافه کنید.

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";

مرحله 10: ذخیره سند

در نهایت، سند Word اصلاح‌شده را در دیسک ذخیره کنید.

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
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");

نتیجه‌گیری

این آموزش به شما نشان داده است که چگونه تصاویر را با استفاده از C# به یک سند Word اضافه کنید. با دنبال کردن این مراحل، می‌توانید هم تصاویر جاسازی‌شده و هم تصاویر لینک‌شده را شامل کنید و کیفیت زیبایی‌شناختی و اطلاعاتی اسناد Word خود را افزایش دهید. برای کاوش بیشتر، ایجاد اسناد Word به صورت برنامه‌نویسی به جای تکیه بر فایل‌های موجود را در نظر بگیرید.

 فارسی