fix: 调整扩展方法，优化单元格设置

Author: jianxuanbing

src/Bing.Offices.Core/Bing/Offices/Metadata/MergedRegionInfo.cs

@@ -0,0 +1,50 @@
+namespace Bing.Offices.Metadata
+{
+    /// <summary>
+    /// 合并区域信息
+    /// </summary>
+    public class MergedRegionInfo
+    {
+        /// <summary>
+        /// 索引
+        /// </summary>
+        public int Index { get; set; }
+
+        /// <summary>
+        /// 左上角X坐标
+        /// </summary>
+        public int FirstRow { get; set; }
+
+        /// <summary>
+        /// 右下角X坐标
+        /// </summary>
+        public int LastRow { get; set; }
+
+        /// <summary>
+        /// 左上角Y坐标
+        /// </summary>
+        public int FirstCol { get; set; }
+
+        /// <summary>
+        /// 右下角Y坐标
+        /// </summary>
+        public int LastCol { get; set; }
+
+        /// <summary>
+        /// 初始化一个<see cref="MergedRegionInfo"/>类型的实例
+        /// </summary>
+        /// <param name="index">索引</param>
+        /// <param name="firstRow">左上角X坐标</param>
+        /// <param name="lastRow">右下角X坐标</param>
+        /// <param name="firstCol">左上角Y坐标</param>
+        /// <param name="lastCol">右下角Y坐标</param>
+        public MergedRegionInfo(int index, int firstRow, int lastRow, int firstCol, int lastCol)
+        {
+            Index = index;
+            FirstRow = firstRow;
+            LastRow = lastRow;
+            FirstCol = firstCol;
+            LastCol = lastCol;
+        }
+    }
+}

src/Bing.Offices.Core/Bing/Offices/Metadata/PictureInfo.cs

@@ -0,0 +1,58 @@
+namespace Bing.Offices.Metadata
+{
+    /// <summary>
+    /// 图片信息
+    /// </summary>
+    public class PictureInfo
+    {
+        /// <summary>
+        /// 最小行索引
+        /// </summary>
+        public int MinRow { get; set; }
+
+        /// <summary>
+        /// 最大行索引
+        /// </summary>
+        public int MaxRow { get; set; }
+
+        /// <summary>
+        /// 最小列索引
+        /// </summary>
+        public int MinCol { get; set; }
+
+        /// <summary>
+        /// 最大列索引
+        /// </summary>
+        public int MaxCol { get; set; }
+
+        /// <summary>
+        /// 图片数据
+        /// </summary>
+        public byte[] PictureData { get; set; }
+
+        /// <summary>
+        /// 图片样式
+        /// </summary>
+        public PictureStyle PictureStyle { get; set; }
+
+        /// <summary>
+        /// 初始化一个<see cref="PictureInfo"/>类型的实例
+        /// </summary>
+        /// <param name="minRow">最小行索引</param>
+        /// <param name="maxRow">最大行索引</param>
+        /// <param name="minCol">最小列索引</param>
+        /// <param name="maxCol">最大列索引</param>
+        /// <param name="pictureData">图片数据</param>
+        /// <param name="pictureStyle">图片样式</param>
+        public PictureInfo(int minRow, int maxRow, int minCol, int maxCol, byte[] pictureData,
+            PictureStyle pictureStyle)
+        {
+            MinRow = minRow;
+            MaxRow = maxRow;
+            MinCol = minCol;
+            MaxCol = maxCol;
+            PictureData = pictureData;
+            PictureStyle = pictureStyle;
+        }
+    }
+}

src/Bing.Offices.Core/Bing/Offices/Metadata/PictureStyle.cs

@@ -0,0 +1,18 @@
+namespace Bing.Offices.Metadata
+{
+    /// <summary>
+    /// 图片样式
+    /// </summary>
+    public class PictureStyle
+    {
+        public int AnchorDx1 { get; set; }
+        public int AnchorDx2 { get; set; }
+        public int AnchorDy1 { get; set; }
+        public int AnchorDy2 { get; set; }
+        public int FillColor { get; set; }
+        public bool IsNoFill { get; set; }
+        public int LineStyle { get; set; }
+        public int LineStyleColor { get; set; }
+        public double LineWidth { get; set; }
+    }
+}

src/Bing.Offices.Npoi/Extensions/CellExtensions.ConditionalFormattin.cs

@@ -0,0 +1,69 @@
+using System.Collections.Generic;
+using System.Linq;
+using NPOI.SS.Util;
+
+namespace Bing.Offices.Npoi.Extensions
+{
+    /// <summary>
+    /// NPOI单元格(<see cref="NPOI.SS.UserModel.ICell"/>) 扩展
+    /// </summary>
+    public static partial class CellExtensions
+    {
+        #region AddConditionalFormattingRules(添加条件格式规则)
+
+        /// <summary>
+        /// 添加条件格式规则
+        /// </summary>
+        /// <param name="cell">单元格</param>
+        /// <param name="cfrs">条件格式规则</param>
+        public static void AddConditionalFormattingRules(this NPOI.SS.UserModel.ICell cell, NPOI.SS.UserModel.IConditionalFormattingRule[] cfrs)
+        {
+            var regions = new[]
+            {
+                new CellRangeAddress(cell.RowIndex, cell.RowIndex, cell.ColumnIndex, cell.ColumnIndex),
+            };
+            cell.Sheet.SheetConditionalFormatting.AddConditionalFormatting(regions, cfrs);
+        }
+
+        #endregion
+
+        #region GetConditionalFormattingRules(获取条件格式规则)
+
+        /// <summary>
+        /// 获取条件格式规则
+        /// </summary>
+        /// <param name="cell">单元格</param>
+        public static NPOI.SS.UserModel.IConditionalFormattingRule[] GetConditionalFormattingRules(this NPOI.SS.UserModel.ICell cell)
+        {
+            var cfrs = new List<NPOI.SS.UserModel.IConditionalFormattingRule>();
+            var scf = cell.Sheet.SheetConditionalFormatting;
+            for (var i = 0; i < scf.NumConditionalFormattings; i++)
+            {
+                var cf = scf.GetConditionalFormattingAt(i);
+                if (cell.ExistConditionalFormatting(cf))
+                {
+                    for (var j = 0; j < cf.NumberOfRules; j++)
+                    {
+                        cfrs.Add(cf.GetRule(j));
+                    }
+                }
+            }
+
+            return cfrs.ToArray();
+        }
+
+        /// <summary>
+        /// 判断单元格是否存在条件格式
+        /// </summary>
+        /// <param name="cell">单元格</param>
+        /// <param name="cf">条件格式</param>
+        private static bool ExistConditionalFormatting(this NPOI.SS.UserModel.ICell cell, NPOI.SS.UserModel.IConditionalFormatting cf)
+        {
+            return cf.GetFormattingRanges().Any(cra =>
+                cell.RowIndex >= cra.FirstRow && cell.RowIndex <= cra.LastRow && cell.ColumnIndex >= cra.FirstColumn &&
+                cell.ColumnIndex <= cra.LastColumn);
+        }
+
+        #endregion
+    }
+}

src/Bing.Offices.Npoi/Extensions/CellExtensions.MergeRegion.cs

@@ -0,0 +1,63 @@
+using System;
+using Bing.Offices.Exceptions;
+using Bing.Offices.Metadata;
+using NPOI.SS.Util;
+
+namespace Bing.Offices.Npoi.Extensions
+{
+    /// <summary>
+    /// NPOI单元格(<see cref="NPOI.SS.UserModel.ICell"/>) 扩展
+    /// </summary>
+    public static partial class CellExtensions
+    {
+        /// <summary>
+        /// 合并单元格
+        /// </summary>
+        /// <param name="fromCell">起始单元格</param>
+        /// <param name="toCell">终止单元格</param>
+        /// <param name="isExpand">扩充模式</param>
+        public static void Merge(this NPOI.SS.UserModel.ICell fromCell, NPOI.SS.UserModel.ICell toCell,
+            bool isExpand = false)
+        {
+            if (!fromCell.Sheet.Equals(toCell.Sheet))
+                throw new OfficeException("单元格不在同一个工作表上");
+            var sheet = fromCell.Sheet;
+            var fromRange = fromCell.GetRangeInfo();
+            var toRange = toCell.GetRangeInfo();
+            var firstRowIndex = Math.Min(fromRange.FirstRow, toRange.FirstRow);
+            var firstColIndex = Math.Min(fromRange.FirstCol, toRange.FirstCol);
+            var lastRowIndex = Math.Max(fromRange.LastRow, toRange.LastRow);
+            var lastColIndex = Math.Max(fromRange.LastCol, toRange.LastCol);
+            var regionInfoList = sheet.GetMergedRegionInfos(firstRowIndex, lastRowIndex, firstColIndex, lastColIndex, false);
+            foreach (var regionInfo in regionInfoList)
+            {
+                if (isExpand)
+                {
+                    firstRowIndex = Math.Min(firstRowIndex, regionInfo.FirstRow);
+                    firstColIndex = Math.Min(firstColIndex, regionInfo.FirstCol);
+                    lastRowIndex = Math.Max(lastRowIndex, regionInfo.LastRow);
+                    lastColIndex = Math.Max(lastColIndex, regionInfo.LastCol);
+                }
+                sheet.RemoveMergedRegion(regionInfo.Index);
+            }
+            var region = new CellRangeAddress(firstRowIndex, lastRowIndex, firstColIndex, lastColIndex);
+            fromCell.Sheet.AddMergedRegion(region);
+        }
+
+        /// <summary>
+        /// 获取合并区域信息
+        /// </summary>
+        /// <param name="cell">NPOI单元格</param>
+        private static MergedRegionInfo GetRangeInfo(this NPOI.SS.UserModel.ICell cell)
+        {
+            var sheet = cell.Sheet;
+            for (var i = 0; i < sheet.NumMergedRegions; i++)
+            {
+                var range = sheet.GetMergedRegion(i);
+                if (range.IsInRange(cell.RowIndex, cell.ColumnIndex))
+                    return new MergedRegionInfo(i, range.FirstRow, range.LastRow, range.FirstColumn, range.LastColumn);
+            }
+            return new MergedRegionInfo(-1, cell.RowIndex, cell.RowIndex, cell.ColumnIndex, cell.ColumnIndex);
+        }
+    }
+}