[AUTO] Comments and Notes Examples Update

comments-and-notes/add-a-threaded-comment-with-multi-line-text-to-cell-h2-and-preserve-line-breaks.cs

@@ -0,0 +1,31 @@
+using System;
+using Aspose.Cells;
+
+namespace AsposeCellsThreadedCommentExample
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook
+            Workbook workbook = new Workbook();
+            Worksheet worksheet = workbook.Worksheets[0];
+
+            // Add a threaded comment author
+            int authorIndex = worksheet.Workbook.Worksheets.ThreadedCommentAuthors.Add(
+                "Demo Author",          // Author name
+                "demo.author@example.com", // User ID (email)
+                "DEMO_PROVIDER");      // Provider ID
+            ThreadedCommentAuthor author = worksheet.Workbook.Worksheets.ThreadedCommentAuthors[authorIndex];
+
+            // Multi-line comment text (preserves line breaks)
+            string commentText = "First line of comment.\nSecond line of comment.\nThird line of comment.";
+
+            // Add a threaded comment to cell H2 (row index 1, column index 7)
+            worksheet.Comments.AddThreadedComment(1, 7, commentText, author);
+
+            // Save the workbook
+            workbook.Save("ThreadedComment_H2.xlsx");
+        }
+    }
+}

comments-and-notes/agents.md

@@ -0,0 +1,81 @@
+# Comments and Notes Examples
+
+This folder contains **Aspose.Cells for .NET** code examples related to:
+
+Comments and Notes
+
+
+## Purpose
+
+These examples demonstrate common **Aspose.Cells APIs** used when working with:
+
+- Workbooks
+- Worksheets
+- Cells
+- Formulas
+- Charts
+- Data operations
+
+
+## Example Files
+
+Each `.cs` file demonstrates a specific task related to **Comments and Notes**.
+
+Example:
+
+create-a-workbook.cs
+
+
+## Required Namespaces
+
+Most examples will require:
+
+using Aspose.Cells;
+
+
+## Common Pattern
+
+Typical Aspose.Cells workflow:
+
+Workbook workbook = new Workbook();
+
+Worksheet sheet = workbook.Worksheets[0];
+
+Cells cells = sheet.Cells;
+
+
+## Output
+
+Examples may generate:
+
+- XLSX files
+- PDF files
+- CSV files
+- Images
+
+Output files are written to the working directory.
+- create-a-new-workbook-and-add-a-threaded-comment-to-cell-a1-with-author-john.cs
+- load-an-existing-workbook-retrieve-all-threaded-comments-from-column-b-and-list-their-authors.cs
+- iterate-through-a-threadedcommentcollection-to-display-each-comments-text-author-and-creation-timestamp.cs
+- edit-a-specific-threaded-comment-by-setting-its-text-property-to-a-new-string-value.cs
+- remove-a-threaded-comment-from-cell-c3-using-the-remove-method-on-the-comment-object.cs
+- set-the-text-direction-of-a-comments-shape-to-righttoleft-for-bidirectional-language-support.cs
+- set-the-text-direction-of-a-comments-shape-to-toptobottom-for-vertical-annotation-layout.cs
+- change-the-font-color-of-a-comment-by-assigning-a-red-value-to-shapetextbodyfontcolor.cs
+- update-the-font-color-of-all-comments-authored-by-alice-to-green-using-shapetextbodyfontcolor.cs
+- apply-a-solid-blue-background-to-a-comment-using-shapefillforecolor-with-the-appropriate-color-code.cs
+- create-a-workbook-add-threaded-comments-to-multiple-cells-and-save-the-file-in-xlsx-format.cs
+- load-a-workbook-modify-comment-font-colors-based-on-author-and-save-changes-to-a-new-file.cs
+- batch-process-a-folder-of-workbooks-adding-a-standard-disclaimer-comment-to-each-worksheets-top-left-cell.cs
+- copy-a-threaded-comment-from-cell-e5-to-cell-f6-while-preserving-its-author-and-text.cs
+- read-all-threaded-comments-from-a-worksheet-and-count-the-number-of-comments-per-author.cs
+- remove-all-comments-older-than-thirty-days-from-a-workbook-based-on-their-createdtime-values.cs
+- scan-a-workbook-for-empty-comments-and-remove-them-to-clean-metadata.cs
+- compare-two-workbooks-by-extracting-their-threaded-comments-and-identifying-differences-in-author-attribution.cs
+- read-the-author-of-each-threaded-comment-in-a-worksheet-and-output-the-list.cs
+- change-the-font-color-of-comments-in-column-g-to-blue-using-shapetextbodyfontcolor.cs
+- add-a-threaded-comment-with-multi-line-text-to-cell-h2-and-preserve-line-breaks.cs
+- retrieve-and-display-the-total-number-of-threaded-comments-present-in-a-workbook.cs
+- update-the-text-direction-of-all-comments-in-a-worksheet-to-lefttoright-for-standard-layout.cs
+- replace-the-background-picture-of-a-comment-with-a-semi-transparent-overlay-image.cs
+- copy-formatting-of-a-comments-shape-including-background-color-and-font-color-to-another-comment.cs

comments-and-notes/apply-a-solid-blue-background-to-a-comment-using-shapefillforecolor-with-the-appropriate-color-code.cs

@@ -0,0 +1,31 @@
+using System;
+using System.Drawing;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+class ApplyBlueBackgroundToComment
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet sheet = workbook.Worksheets[0];
+
+        // Add a comment to cell A1
+        int commentIndex = sheet.Comments.Add("A1");
+        Comment comment = sheet.Comments[commentIndex];
+        comment.Note = "This is a sample comment";
+
+        // Access the shape associated with the comment
+        Shape commentShape = comment.CommentShape;
+
+        // Make sure the shape's fill is visible
+        commentShape.IsFilled = true;
+
+        // Apply a solid blue background using the FillFormat's ForeColor
+        commentShape.FillFormat.ForeColor = Color.Blue;
+
+        // Save the workbook
+        workbook.Save("CommentBlueBackground.xlsx");
+    }
+}

comments-and-notes/batch-process-a-folder-of-workbooks-adding-a-standard-disclaimer-comment-to-each-worksheets-top-left-cell.cs

@@ -0,0 +1,46 @@
+using System;
+using System.IO;
+using Aspose.Cells;
+
+namespace BatchDisclaimer
+{
+    public static class WorkbookProcessor
+    {
+        // Adds a disclaimer comment to the top‑left cell (A1) of every worksheet in all workbooks
+        // found in the specified folder. The original files are overwritten with the updated version.
+        public static void AddDisclaimerToFolder(string folderPath, string disclaimer)
+        {
+            // Get all Excel files in the folder (you can adjust the pattern if needed)
+            string[] files = Directory.GetFiles(folderPath, "*.xlsx", SearchOption.TopDirectoryOnly);
+
+            foreach (string filePath in files)
+            {
+                // Load the workbook using the constructor that accepts a file path
+                using (Workbook workbook = new Workbook(filePath))
+                {
+                    // Iterate through each worksheet in the workbook
+                    foreach (Worksheet sheet in workbook.Worksheets)
+                    {
+                        // Add a comment to cell A1 (top‑left cell)
+                        int commentIndex = sheet.Comments.Add("A1");
+                        sheet.Comments[commentIndex].Note = disclaimer;
+                    }
+
+                    // Save the modified workbook back to the same file (overwrite)
+                    workbook.Save(filePath);
+                }
+            }
+        }
+
+        // Example usage
+        public static void Main()
+        {
+            string folder = @"C:\ExcelFiles"; // Folder containing the workbooks
+            string disclaimerText = "This workbook is confidential and intended for authorized personnel only.";
+
+            AddDisclaimerToFolder(folder, disclaimerText);
+
+            Console.WriteLine("Disclaimer added to all workbooks in the folder.");
+        }
+    }
+}

comments-and-notes/change-the-font-color-of-a-comment-by-assigning-a-red-value-to-shapetextbodyfontcolor.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Drawing;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+namespace AsposeCellsCommentFontColor
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet worksheet = workbook.Worksheets[0];
+
+            // Add a comment to cell A1
+            int commentIndex = worksheet.Comments.Add("A1");
+            Comment comment = worksheet.Comments[commentIndex];
+            comment.Note = "This is a sample comment";
+
+            // Access the shape attached to the comment
+            CommentShape commentShape = comment.CommentShape;
+
+            // Ensure the shape has a TextBody collection
+            // Set the font color of the first text run to red
+            // (FontSettingCollection items expose a Font property)
+            commentShape.TextBody[0].Font.Color = Color.Red;
+
+            // Optionally make the comment visible
+            comment.IsVisible = true;
+
+            // Save the workbook
+            workbook.Save("CommentWithRedFont.xlsx");
+        }
+    }
+}

comments-and-notes/change-the-font-color-of-comments-in-column-g-to-blue-using-shapetextbodyfontcolor.cs

@@ -0,0 +1,44 @@
+using System;
+using System.Drawing;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+class ChangeCommentFontColorInColumnG
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet worksheet = workbook.Worksheets[0];
+
+        // Add sample comments in column G (index 6)
+        for (int row = 0; row < 5; row++)
+        {
+            // Add a comment to cell G{row+1}
+            int commentIndex = worksheet.Comments.Add(row, 6);
+            Comment comment = worksheet.Comments[commentIndex];
+            comment.Note = $"Comment at G{row + 1}";
+        }
+
+        // Iterate through all comments and change font color to blue for those in column G
+        foreach (Comment comment in worksheet.Comments)
+        {
+            if (comment.Column == 6) // Column G (zero‑based index)
+            {
+                // Access the shape associated with the comment
+                CommentShape shape = comment.CommentShape;
+
+                // Use the TextBody collection to set the font color.
+                // The TextBody collection contains FontSetting objects; we modify the first (and only) one.
+                // This changes the font color of the entire comment text.
+                shape.TextBody[0].Font.Color = Color.Blue;
+
+                // Ensure the comment is visible (optional)
+                comment.IsVisible = true;
+            }
+        }
+
+        // Save the workbook
+        workbook.Save("CommentsColumnG_BlueFont.xlsx");
+    }
+}