
چگونه میتوان تصاویر را در اکسل با استفاده از Node.js وارد کرد
برخی از کارهای مشترک وجود دارد که شما به طور روزانه انجام میدهید مانند بارگذاری تصاویر، بهروزرسانی عکسهای موجود، وارد کردن دادهها و بسیاری موارد دیگر. شما میتوانید این کارها را به طور برنامهنویسی با استفاده از هر کتابخانه موجود خودکار کنید. در این پست وبلاگ، ما به این JS Excel library خواهیم پرداخت تا بیاموزیم چگونه میتوان تصاویر را به Excel با استفاده از Node.js وارد کنیم. پس از خواندن این مقاله، شما قادر خواهید بود یک کد نمونه بنویسید که به طور برنامهنویسی تصاویر را به یک Worksheet وارد کند.
ما بخشهای زیر را در این راهنما پوشش خواهیم داد:
نصب کتابخانه JS Excel
فرایند نصب این library بسیار دوستانه برای توسعهدهندگان است. شما میتوانید به راحتی آن را با downloading بسته API یا اجرای دستورات زیر در ترمینال راهاندازی کنید.
npm install java
npm install aspose.cells
چگونه در Excel با استفاده از Node.js تصاویر را وارد کنیم
حال میتوانیم کد منبع را بنویسیم و متدها را برای وارد کردن تصاویر به فایلهای اکسل بهصورت برنامهنویسی فراخوانی کنیم.
مراحل و کد نمونه ذکر شده در زیر را دنبال کنید:
- یک نمونه از کلاس Workbook ایجاد کنید.
- Invoke the getWorksheets method that gets the WorksheetCollection collection in the spreadsheet.
- مرجع برگه اول را با فراخوانی get متد به دست آورید.
- برای اضافه کردن یک تصویر در محل یک سلول که اندیس های ردیف و ستون آن ۵ است، از روش add استفاده کنید.
- get عنصر تصویر در اندیس مشخص شده را بگیرید.
- ذخیره فایل اکسل با فراخوانی متد save.
کپی و چسباندن کد زیر در فایل اصلی خود:
var fs = require('fs');
var aspose = aspose || {};
aspose.cells = require("aspose.cells");
// یک نمونه از کلاس Workbook ایجاد کنید
var workbook = new aspose.cells.Workbook();
// Invoke the getWorksheets method that gets the WorksheetCollection collection in the spreadsheet.
var worksheets = workbook.getWorksheets();
// با فراخوانی متد get، به مرجع اولین برگه کار دسترسی پیدا کنید.
var sheet = worksheets.get(0);
// اضافه کردن یک تصویر در موقعیت یک سلول که ایندکسهای ردیف و ستون آن ۵ در برگه کار است. این سلول "F6" است.
var pictureIndex = sheet.getPictures().add(5, 5, "qr.jpeg");
// عکس را در اندیس مشخص شده بگیرید.
var picture = sheet.getPictures().get(pictureIndex);
// ذخیره فایل اکسل با فراخوانی متد save
workbook.save( "book1.xls");
شما ممکن است خروجی را در تصویر زیر ببینید:

موقعیت تصویر
علاوه بر این، ممکن است کد اسنیپت خود را بیشتر با استفاده از روشهای پیشرفته پیکربندی کنیم.
شما میتوانید مراحل زیر را برای قرار دادن تصویر به صورت برنامهنویسی دنبال کنید:
- ایجاد یک Workbook شیء.
- اضافه کردن یک برگه جدید با فراخوانی متد add.
- Call the get method to access the Worksheet element at the specified index.
- Invoke the add method to add the picture to the collection.
- به عنصر تصویر در ایندکس مشخص شده با فراخوانی get متد دسترسی پیدا کنید.
- متد setUpperDeltaX را برای تعیین فاصله افقی شکل از گوشه سمت چپ بالای آن فراخوانی کنید. محدوده مقدار از 0 تا 1024 است.
- Set the shape’s vertical offset from its upper left corner row by calling the setUpperDeltaY method.
- متد save را برای ذخیره فایل Excel فراخوانی کنید.
کپی و چسباندن کد زیر در فایل اصلی خود:
var fs = require('fs');
var aspose = aspose || {};
aspose.cells = require("aspose.cells");
// شیء Workbook را نمونهسازی میکنیم
var workbook = new aspose.cells.Workbook();
// اضافه کردن یک شیت جدید با فراخوانی متد add.
var sheetIndex = workbook.getWorksheets().add();
// روش get را برای دسترسی به عنصر Worksheet در ایندکس مشخص شده فراخوانی کنید.
var worksheet = workbook.getWorksheets().get(sheetIndex);
// متد add را فراخوانی کنید تا تصویر را به مجموعه اضافه کنید.
var pictureIndex = worksheet.getPictures().add(2, 2, "qr.jpeg");
// عناصر Picture را در شاخص مشخص شده دسترسی پیدا کنید.
var picture = worksheet.getPictures().get(pictureIndex);
// متد setUpperDeltaX را برای تنظیم افست افقی شکل از گوشه بالای چپ خود فراخوانی کنید. محدوده مقدار از ۰ تا ۱۰۲۴ است.
picture.setUpperDeltaX(200);
// شکل را با فراخوانی روش setUpperDeltaY از گوشه بالای چپ آن، جابجایی عمودی تنظیم کنید.
picture.setUpperDeltaY(200);
// متد save را فراخوانی کنید تا فایل اکسل را ذخیره کنید.
workbook.save( "test_pictures.xls");
خروجی را میتوان در تصویر زیر مشاهده کرد:

مجوز رایگان بگیرید
شما میتوانید از یک مجوز موقت رایگان برای امتحان API بدون محدودیتهای ارزیابی استفاده کنید.
جمعبندی
این پایان این پست وبلاگ آموزشی است. شما یاد گرفتید که چگونه تصاویر را در Excel با استفاده از Node.js وارد کنید. علاوه بر این، شما همچنین یاد گرفتید که چگونه تصاویر را با استفاده از این کتابخانه JS Excel دستکاری کنید. به علاوه، میتوانید به documentation مراجعه کنید تا با سایر ویژگیها آشنا شوید.
علاوه بر این، ما به شما پیشنهاد میکنیم که راهنمای Getting Started guide ما را دنبال کنید.
بالاخره، conholdate.com در حال نوشتن پستهای جدید وبلاگ است. بنابراین، لطفاً برای دریافت بهروزرسانیهای منظم در تماس باشید.
سوال بپرسید
شما میتوانید سوالات یا درخواستهای خود را در forum به ما اطلاع دهید.
سوالات متداول
How do I insert an image into an XLSX file?
لطفاً به این link مراجعه کنید تا درباره کد نمونهای که تصاویر را به صورت برنامهنویسی در یک فایل اکسل درج میکند، اطلاع کسب کنید.