[New] MiniExcel AddPicture (#770)

* [New] MiniExcel AddPicture

* Support default sheet entry and spesific sheet name

* Support CellAddress and default WidthPx, HeightPx

* [doc] MiniExcel.AddPicture

Author: shps951023

README.md

@@ -1488,10 +1488,30 @@ var config = new OpenXmlConfiguration() { FastMode = true };
 MiniExcel.SaveAs(path, reader,configuration:config);
 ```
 
+#### 6. Batch Add Image (MiniExcel.AddPicture)
 
-
-
-
+```csharp
+var images = new[]
+{
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/github_logo.png")),
+        SheetName = null, // default null is first sheet
+        CellAddress = "C3", // required
+    },
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/google_logo.png")),
+        PictureType = "image/png", // default PictureType = image/png
+        SheetName = "Demo",
+        CellAddress = "C9", // required
+        WidthPx = 100,
+        HeightPx = 100,
+    },
+};
+MiniExcel.AddPicture(path, images);
+```
+![Image](https://github.com/user-attachments/assets/19c4d241-9753-4ede-96c8-f810c1a22247)
 
 ### Examples:
 

README.zh-CN.md

@@ -1631,7 +1631,30 @@ public class Order
 
 
 
+#### 6. 批量添加/插入图片 (MiniExcel.AddPicture)
 
+```csharp
+var images = new[]
+{
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/github_logo.png")),
+        SheetName = null, // default null is first sheet
+        CellAddress = "C3", // required
+    },
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/google_logo.png")),
+        PictureType = "image/png", // default PictureType = image/png
+        SheetName = "Demo",
+        CellAddress = "C9", // required
+        WidthPx = 100,
+        HeightPx = 100,
+    },
+};
+MiniExcel.AddPicture(path, images);
+```
+![Image](https://github.com/user-attachments/assets/19c4d241-9753-4ede-96c8-f810c1a22247)
 
 
 

README.zh-Hant.md

@@ -1363,6 +1363,33 @@ var config = new OpenXmlConfiguration() { FastMode = true };
 MiniExcel.SaveAs(path, reader,configuration:config);
 ```
 
+#### 6. 批量添加/插入圖片 (MiniExcel.AddPicture)
+
+```csharp
+var images = new[]
+{
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/github_logo.png")),
+        SheetName = null, // default null is first sheet
+        CellAddress = "C3", // required
+    },
+    new MiniExcelPicture
+    {
+        ImageBytes = File.ReadAllBytes(PathHelper.GetFile("images/google_logo.png")),
+        PictureType = "image/png", // default PictureType = image/png
+        SheetName = "Demo",
+        CellAddress = "C9", // required
+        WidthPx = 100,
+        HeightPx = 100,
+    },
+};
+MiniExcel.AddPicture(path, images);
+```
+
+![Image](https://github.com/user-attachments/assets/19c4d241-9753-4ede-96c8-f810c1a22247)
+
+
 
 
 ### 範例

samples/xlsx/TestIssue186_Template.xlsx

@@ -1,5 +1,6 @@
 namespace MiniExcelLibs
 {
+    using MiniExcelLibs.Picture;
     using OpenXml;
     using System;
     using System.Collections;
@@ -13,6 +14,15 @@
 
     public static partial class MiniExcel
     {
+        public static void AddPicture(string path, params MiniExcelPicture[] images)
+        {
+            using (var stream = File.Open(path,FileMode.OpenOrCreate))
+                MiniExcelPictureImplement.AddPicture(stream, images);
+        }
+        public static void AddPicture(Stream excelStream, params MiniExcelPicture[] images)
+        {
+            MiniExcelPictureImplement.AddPicture(excelStream, images);
+        }
         public static MiniExcelDataReader GetReader(string path, bool useHeaderRow = false, string sheetName = null, ExcelType excelType = ExcelType.UNKNOWN, string startCell = "A1", IConfiguration configuration = null)
         {
             var stream = FileHelper.OpenSharedRead(path);

samples/xlsx/TestIssue186_Template2.xlsx

@@ -0,0 +1,16 @@
+using MiniExcelLibs.Utils;
+
+namespace MiniExcelLibs.Picture
+{
+    public class MiniExcelPicture
+    {
+        public byte[] ImageBytes { get; set; }
+        public string SheetName { get; set; }
+        public string PictureType { get; set; }
+        public string CellAddress { get; set; }
+        internal int ColumnNumber => ReferenceHelper.ConvertCellToXY(CellAddress).Item1 -1;
+        internal int RowNumber => ReferenceHelper.ConvertCellToXY(CellAddress).Item2 - 1;
+        public int WidthPx { get; set; }
+        public int HeightPx { get; set; }
+    }
+}

samples/xlsx/TestIssueIBAJXH.xlsx

@@ -5,7 +5,7 @@
 using MiniExcelLibs.Utils;
 
 namespace MiniExcelLibs.OpenXml.SaveByTemplate
-{
+{
     public class InputValueExtractor : IInputValueExtractor
     {
         public IDictionary<string, object> ToValueDictionary(object valueObject)