Initial commit of the ClosedXML library

Establishes the foundational structure, core Excel functionality, and tooling. - Implements base components for cells, ranges, columns, and rows. - Integrates a custom calculation engine with a wide range of Excel functions. - Adds comprehensive support for styling, conditional formatting, data validation, comments, pictures, and charts. - Configures build setup, project metadata (NuGet), and developer guidelines. - Includes editor and Git attributes for consistent code style and line endings.
2026-06-23 11:02:53 -05:00
parent 28bc05cf54
commit 2cd6df6481
1092 changed files with 97270 additions and 408 deletions
@@ -0,0 +1,121 @@
+using System;
+using ClosedXML.Excel;
+
+namespace ClosedXML_Examples.Styles
+{
+    public class UsingRichText : IXLExample
+    {
+        #region Variables
+
+        // Public
+
+        // Private
+
+
+        #endregion
+
+        #region Properties
+
+        // Public
+
+        // Private
+
+        // Override
+
+
+        #endregion
+
+        #region Constructors
+
+        // Public
+
+
+
+        // Private
+
+
+        #endregion
+
+        #region Events
+
+        // Public
+
+        // Private
+
+        // Override
+
+
+        #endregion
+
+        #region Methods
+
+        // Public
+        public void Create(String filePath)
+        {
+            var wb = new XLWorkbook();
+            var ws = wb.Worksheets.Add("Rich Text");
+
+            // Let's start with a plain text and then decorate it...
+            var cell1 = ws.Cell(1, 1).SetValue("The show must go on...");
+
+            // We want everything in blue except the word show 
+            // (which we want in red and with Courier Font)
+            cell1.Style.Font.FontColor = XLColor.Blue; // Set the color for the entire cell
+            cell1.RichText.Substring(4, 4)
+                .SetFontColor(XLColor.Red)
+                .SetFontName("Courier"); // Set the color and font for the word "show"
+
+            // On the next example we'll start with an empty cell and add the rich text
+            var cell = ws.Cell(3, 1);
+
+            // Add the text parts
+            cell.RichText.AddText("Hello").SetFontColor(XLColor.Red);
+            cell.RichText.AddText(" BIG ").SetFontColor(XLColor.Blue).SetBold();
+            cell.RichText.AddText("World").SetFontColor(XLColor.Red);
+
+            // Here we're showing that even though we added three pieces of text
+            // you can treat then like a single one.
+            cell.RichText.Substring(4, 7).SetUnderline();
+
+            // Right now cell.RichText has the following 5 strings:
+            // 
+            // "Hell"  -> Red
+            // "o"     -> Red, Underlined
+            // " BIG " -> Blue, Underlined, Bold
+            // "W"     -> Red, Underlined
+            // "orld"  -> Red
+
+            // Of course you can loop through each piece of text and check its properties
+            foreach (var richText in cell.RichText)
+            {
+                if(richText.Bold)
+                    ws.Cell(3, 2).Value = String.Format("\"{0}\" is Bold.", richText.Text);
+            }
+
+
+            // Now we'll build a cell with rich text, and some other styles 
+            cell = ws.Cell(5, 1);
+
+            // Add the text parts
+            cell.RichText.AddText("Some").SetFontColor(XLColor.Green);
+            cell.RichText.AddText(" rich text ").SetFontColor(XLColor.Blue).SetBold();
+            cell.RichText.AddText("with a gray background").SetItalic();
+
+            cell.Style.Fill.SetBackgroundColor(XLColor.Gray);
+
+            ws.Cell(5, 2).Value = cell.RichText; // Should copy only rich text, but not background
+
+
+            ws.Columns().AdjustToContents();
+
+            wb.SaveAs(filePath);
+        }
+
+        // Private
+
+        // Override
+
+
+        #endregion
+    }
+}