Implemented new features and enhancements in the Range class

- Added ClearRange and MergeCells methods to the Range class, enabling the clearing of cell contents and merging of cells within specified ranges.
- Implemented ColumnCount and RowCount properties in the Range class to provide easy access to the number of columns and rows in a given range.
- Developed the AddDropdownListValidation method in the Worksheet class for adding dropdown list data validation to cells.
- Introduced ColumnWidth and RowHeight methods to retrieve the width of a column and the height of a row, enhancing cell dimension handling capabilities.

These enhancements aim to improve the flexibility and utility of the Range class, offering more advanced functionalities for manipulating and validating spreadsheet data.

Author: Fahad Adeel

FileFormat.Cells/Range.cs

@@ -15,6 +15,19 @@ public class Range
         public uint EndRowIndex { get; }
         public uint EndColumnIndex { get; }
 
+        // Returns the count of columns in the range
+        public uint ColumnCount
+        {
+            get { return EndColumnIndex - StartColumnIndex + 1; }
+        }
+
+        // Returns the count of rows in the range
+        public uint RowCount
+        {
+            get { return EndRowIndex - StartRowIndex + 1; }
+        }
+
+        
         public Range(Worksheet worksheet, uint startRowIndex, uint startColumnIndex, uint endRowIndex, uint endColumnIndex)
         {
             _worksheet = worksheet ?? throw new ArgumentNullException(nameof(worksheet));
@@ -37,6 +50,48 @@ public void SetValue(string value)
             }
         }
 
+        public void ClearCells()
+        {
+            for (uint row = StartRowIndex; row <= EndRowIndex; row++)
+            {
+                for (uint column = StartColumnIndex; column <= EndColumnIndex; column++)
+                {
+                    var cellReference = $"{ColumnIndexToLetter(column)}{row}";
+                    var cell = _worksheet.GetCell(cellReference);
+                    if (cell != null)
+                    {
+                        cell.PutValue(string.Empty); // Clearing the value
+                        cell.ApplyStyle(0); // Resetting the style if needed
+                    }
+                }
+            }
+        }
+
+        public void MergeCells()
+        {
+            string startCellReference = $"{ColumnIndexToLetter(StartColumnIndex)}{StartRowIndex}";
+            string endCellReference = $"{ColumnIndexToLetter(EndColumnIndex)}{EndRowIndex}";
+
+            _worksheet.MergeCells(startCellReference, endCellReference);
+        }
+
+
+        public void AddDropdownListValidation(string[] options)
+        {
+            
+
+            for (uint row = StartRowIndex; row <= EndRowIndex; row++)
+            {
+                for (uint column = StartColumnIndex; column <= EndColumnIndex; column++)
+                {
+                    var cellReference = $"{ColumnIndexToLetter(column)}{row}";
+                    _worksheet.AddDropdownListValidation(cellReference, options);
+                }
+            }
+        }
+
+
+
         private static string ColumnIndexToLetter(uint columnIndex)
         {
             string columnLetter = string.Empty;

FileFormat.Cells/Worksheet.cs

@@ -5,6 +5,7 @@
 using DocumentFormat.OpenXml.Packaging;
 using DocumentFormat.OpenXml.Spreadsheet;
 
+
 namespace FileFormat.Cells
 {
     /// <summary>
@@ -15,6 +16,10 @@ public sealed class Worksheet
         private WorksheetPart _worksheetPart;
         private SheetData _sheetData;
 
+        public const double DefaultColumnWidth = 8.43; // Default width in character units
+        public const double DefaultRowHeight = 15.0;   // Default height in points
+
+
         /// <summary>
         /// Gets the indexer for cells within the worksheet.
         /// </summary>
@@ -171,6 +176,51 @@ public void SetColumnWidth(string columnName, double width)
             }
         }
 
+        public double GetColumnWidth(uint columnIndex)
+        {            
+            // Access the Columns collection
+            var columns = _worksheetPart.Worksheet.GetFirstChild<DocumentFormat.OpenXml.Spreadsheet.Columns>();
+            if (columns != null)
+            {
+                foreach (var column in columns.Elements<Column>())
+                {
+                    
+                    // Explicitly cast Min and Max to uint and check for null
+                    uint min = column.Min.HasValue ? column.Min.Value : uint.MinValue;
+                    uint max = column.Max.HasValue ? column.Max.Value : uint.MaxValue;
+
+                    if (columnIndex >= min && columnIndex <= max)
+                    {
+                        // Also check if Width is set
+                        return column.Width.HasValue ? column.Width.Value : DefaultColumnWidth;
+                    }
+                }
+            }
+
+            return DefaultColumnWidth;
+        }
+
+        public double GetRowHeight(uint rowIndex)
+        {
+            // Assuming _worksheetPart is the OpenXML WorksheetPart
+            var rows = _worksheetPart.Worksheet.GetFirstChild<DocumentFormat.OpenXml.Spreadsheet.SheetData>().Elements<Row>();
+
+            foreach (var row in rows)
+            {
+                // Check if this is the row we are looking for
+                if (row.RowIndex.Value == rowIndex)
+                {
+                    // If Height is set, return it, otherwise return default height
+                    return row.Height.HasValue ? row.Height.Value : DefaultRowHeight;
+                }
+            }
+
+            return DefaultRowHeight; // Return default height if no specific height is set
+        }
+
+
+
+
         /// <summary>
         /// Protects the worksheet with the specified password.
         /// </summary>
@@ -395,6 +445,35 @@ public Range GetRange(string startCellReference, string endCellReference)
             return GetRange(startCellParts.row, startCellParts.column, endCellParts.row, endCellParts.column);
         }
 
+        public void AddDropdownListValidation(string cellReference, string[] options)
+        {
+            // Convert options array into a comma-separated string
+            string formula = string.Join(",", options);
+
+            // Create the data validation object
+            DataValidation dataValidation = new DataValidation
+            {
+                Type = DataValidationValues.List,
+                ShowDropDown = true,
+                ShowErrorMessage = true,
+                ErrorTitle = "Invalid input",
+                Error = "The value entered is not in the list.",
+                Formula1 = new Formula1("\"" + formula + "\""), // The formula is enclosed in quotes
+                SequenceOfReferences = new ListValue<StringValue> { InnerText = cellReference }
+            };
+
+            // Add the data validation to the worksheet
+            var dataValidations = _worksheetPart.Worksheet.GetFirstChild<DataValidations>();
+            if (dataValidations == null)
+            {
+                dataValidations = new DataValidations();
+                _worksheetPart.Worksheet.AppendChild(dataValidations);
+            }
+
+            dataValidations.AppendChild(dataValidation);
+        }
+
+
         private (uint row, uint column) ParseCellReference(string cellReference)
         {
             var match = Regex.Match(cellReference, @"([A-Z]+)(\d+)");