[AUTO] Macro Project Examples Update

macro-project/add-a-com-library-reference-eg-microsoft-scripting-runtime-to-the-vba-project.cs

@@ -0,0 +1,28 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+namespace AsposeCellsVbaReferenceDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook (macro-enabled format will be used on save)
+            Workbook workbook = new Workbook();
+
+            // Access the VBA project associated with the workbook
+            VbaProject vbaProject = workbook.VbaProject;
+
+            // Define the LibID for the Microsoft Scripting Runtime (scrrun.dll)
+            // The format is: *\G{<GUID>}#<Version>#0#<FullPath>#<Description>
+            string scriptingLibId = "*\\G{420B2830-E718-11CF-893D-00A0C9054228}#1.0#0#C:\\Windows\\System32\\scrrun.dll#Microsoft Scripting Runtime";
+
+            // Add the COM library reference to the VBA project
+            vbaProject.References.AddRegisteredReference("Scripting", scriptingLibId);
+
+            // Save the workbook as a macro-enabled file (XLSM)
+            workbook.Save("WorkbookWithScriptingReference.xlsm", SaveFormat.Xlsm);
+        }
+    }
+}

macro-project/add-a-custom-reference-to-a-vba-project-that-points-to-a-com-library-installed-on-the-system.cs

@@ -0,0 +1,26 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+class AddComReference
+{
+    static void Main()
+    {
+        // Create a new workbook (macro-enabled)
+        Workbook workbook = new Workbook();
+
+        // Access the VBA project associated with the workbook
+        VbaProject vbaProject = workbook.VbaProject;
+
+        // Define the COM library reference (Automation type library)
+        // Example: Microsoft Scripting Runtime (scrrun.dll)
+        string referenceName = "Scripting";
+        string libid = "*\\G{420B2830-E718-11CF-893D-00A0C9054228}#1.0#0#C:\\Windows\\System32\\scrrun.dll#Scripting Runtime";
+
+        // Add the reference to the VBA project
+        vbaProject.References.AddRegisteredReference(referenceName, libid);
+
+        // Save the workbook as a macro-enabled file
+        workbook.Save("WorkbookWithComReference.xlsm", SaveFormat.Xlsm);
+    }
+}

macro-project/add-a-module-that-references-external-com-libraries-and-ensure-the-references-compile-correctly.cs

@@ -0,0 +1,55 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+namespace AsposeCellsComReferenceDemo
+{
+    public class Program
+    {
+        public static void Main()
+        {
+            // Create a new workbook (macro-enabled format will be used on save)
+            Workbook workbook = new Workbook();
+
+            // Access the VBA project associated with the workbook
+            VbaProject vbaProject = workbook.VbaProject;
+
+            // ------------------------------------------------------------
+            // Add a reference to an external COM (Automation) library.
+            // Here we reference the standard OLE Automation library (stdole).
+            // ------------------------------------------------------------
+            vbaProject.References.AddRegisteredReference(
+                "stdole",
+                "*\\G{00020430-0000-0000-C000-000000000046}#2.0#0#C:\\Windows\\system32\\stdole2.tlb#OLE Automation");
+
+            // ------------------------------------------------------------
+            // Optionally, add a control reference (e.g., Microsoft Forms 2.0).
+            // This demonstrates adding a twiddled type library reference.
+            // ------------------------------------------------------------
+            vbaProject.References.AddControlRefrernce(
+                "MSForms",
+                "*\\G{0D452EE1-E08F-101A-852E-02608C4D0BB4}#2.0#0#C:\\Windows\\system32\\FM20.DLL#Microsoft Forms 2.0 Object Library",
+                "twiddledLibid_placeholder",
+                "extendedLibid_placeholder");
+
+            // ------------------------------------------------------------
+            // Add a new VBA module to the project.
+            // The module type is Class, and we give it a meaningful name.
+            // ------------------------------------------------------------
+            int moduleIndex = vbaProject.Modules.Add(VbaModuleType.Class, "ComHelperModule");
+            VbaModule module = vbaProject.Modules[moduleIndex];
+
+            // Insert VBA code that utilizes the referenced COM library.
+            // Example: use the stdole library to create a picture object.
+            module.Codes = @"
+Public Sub ShowStdOleMessage()
+    Dim pic As stdole.StdPicture
+    MsgBox ""COM library reference is working!""
+End Sub
+";
+
+            // Save the workbook as a macro-enabled file so that the VBA project is retained.
+            workbook.Save("ComReferenceDemo.xlsm", SaveFormat.Xlsm);
+        }
+    }
+}

macro-project/add-a-reference-to-the-microsoft-outlook-object-library-in-the-vba-project-to-enable-email-automation.cs

@@ -0,0 +1,45 @@
+using System;
+using System.Text;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+namespace AsposeCellsVbaOutlookReference
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook (macro-enabled format will be used when saving)
+            Workbook workbook = new Workbook();
+
+            // Access the VBA project (automatically created for .xlsm files)
+            VbaProject vbaProject = workbook.VbaProject;
+
+            // Optional: set project name and encoding
+            vbaProject.Name = "OutlookAutomationProject";
+            vbaProject.Encoding = Encoding.UTF8;
+
+            // Add a reference to the Microsoft Outlook Object Library
+            // The libid string below is an example for Outlook 16.0; adjust the path/version as needed.
+            string outlookLibId = "*\\G{00062FFF-0000-0000-C000-000000000046}#9.0#0#C:\\Program Files\\Microsoft Office\\Office16\\MSOUTL.OLB#Microsoft Outlook 16.0 Object Library";
+            vbaProject.References.AddRegisteredReference("Outlook", outlookLibId);
+
+            // (Optional) Add a simple VBA module that uses Outlook – just for demonstration
+            int moduleIndex = vbaProject.Modules.Add(VbaModuleType.Class, "EmailHelper");
+            vbaProject.Modules[moduleIndex].Codes =
+                "Sub SendMail()\r\n" +
+                "    Dim olApp As Outlook.Application\r\n" +
+                "    Dim olMail As Outlook.MailItem\r\n" +
+                "    Set olApp = New Outlook.Application\r\n" +
+                "    Set olMail = olApp.CreateItem(0)\r\n" +
+                "    olMail.Subject = \"Test Email\"\r\n" +
+                "    olMail.Body = \"This email was sent from VBA in an Excel workbook.\"\r\n" +
+                "    olMail.Recipients.Add \"example@example.com\"\r\n" +
+                "    olMail.Send\r\n" +
+                "End Sub";
+
+            // Save the workbook as a macro-enabled file
+            workbook.Save("WorkbookWithOutlookReference.xlsm", SaveFormat.Xlsm);
+        }
+    }
+}

macro-project/add-a-reference-to-the-microsoft-xml-v60-library-in-the-vba-project-to-enable-xml-parsing.cs

@@ -0,0 +1,29 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+class AddMsXmlReference
+{
+    static void Main()
+    {
+        // Create a new workbook
+        Workbook workbook = new Workbook();
+
+        // Save as a macro‑enabled workbook to ensure a VBA project is created,
+        // then reload it so the VbaProject property is available.
+        string tempPath = "temp.xlsm";
+        workbook.Save(tempPath, SaveFormat.Xlsm);
+        workbook = new Workbook(tempPath);
+
+        // Access the VBA project
+        VbaProject vbaProject = workbook.VbaProject;
+
+        // Add a reference to Microsoft XML, v6.0 (MSXML6) library
+        vbaProject.References.AddRegisteredReference(
+            "MSXML2",
+            "*\\G{88D969C0-F192-11D4-A65F-0040963251E5}#6.0#0#C:\\Windows\\System32\\msxml6.dll#Microsoft XML, v6.0");
+
+        // Save the workbook with the added reference
+        workbook.Save("WorkbookWithMsXmlReference.xlsm", SaveFormat.Xlsm);
+    }
+}

macro-project/add-a-registered-library-reference-to-the-vba-project-using-vbaprojectreferencesaddregisteredreference.cs

@@ -0,0 +1,44 @@
+using System;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+namespace AsposeCellsVbaReferenceDemo
+{
+    public class AddRegisteredReferenceDemo
+    {
+        public static void Run()
+        {
+            try
+            {
+                // Create a new workbook (will become macro-enabled when saved as .xlsm)
+                Workbook workbook = new Workbook();
+
+                // Access the VBA project associated with the workbook
+                VbaProject vbaProject = workbook.VbaProject;
+
+                // Add a registered reference to an Automation type library (example: stdole)
+                vbaProject.References.AddRegisteredReference(
+                    "stdole",
+                    "*\\G{00020430-0000-0000-C000-000000000046}#2.0#0#C:\\Windows\\system32\\stdole2.tlb#OLE Automation");
+
+                // Define output file path
+                string outputPath = "output.xlsm";
+
+                // Save the workbook as a macro-enabled file
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved successfully to '{Path.GetFullPath(outputPath)}'.");
+            }
+            catch (Exception ex)
+            {
+                Console.Error.WriteLine($"Error: {ex.Message}");
+            }
+        }
+
+        // Entry point for the application
+        public static void Main(string[] args)
+        {
+            Run();
+        }
+    }
+}

macro-project/agents.md

@@ -0,0 +1,116 @@
+---
+category: macro-project
+framework: .NET
+parent: ../agents.md
+version: v2
+---
+
+# Persona
+
+You are a C# developer specializing in VBA projects, macros, and workbook automation using Aspose.Cells for .NET.
+
+Generate simple, correct, production-quality examples that demonstrate ONE macro-project scenario at a time.
+
+---
+
+# Scope
+
+- Standalone .cs examples
+- One operation per example
+- Fully runnable with dotnet run
+- No external dependencies
+
+---
+
+# Required Namespaces
+
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Vba;
+
+---
+
+# Key APIs
+
+- VbaProject
+- VbaModule
+- Workbook.VbaProject
+- VbaProject.Modules
+- VbaModuleCollection
+
+---
+
+# Common Pattern
+
+1. Create workbook
+2. Access or create VBA project
+3. Add, read, or modify VBA modules
+4. Verify project structure
+5. Save workbook
+6. Print success message
+
+---
+
+# Macro Project Rules
+
+- Demonstrate one VBA feature per example
+- Use meaningful module names
+- Keep VBA code samples small and readable
+- Focus on project management rather than complex VBA logic
+
+---
+
+# Input Strategy
+
+- Do NOT rely on external XLSM files
+- Create workbook and VBA content programmatically
+- Keep examples self-contained
+
+---
+
+# Output Rules
+
+- Always generate output.xlsm when macros are involved
+- Ensure workbook is saved successfully
+- Output files are written to the working directory
+
+---
+
+# Common Tasks
+
+- Create VBA project
+- Add VBA module
+- Read VBA modules
+- Modify VBA code
+- Access VBA project information
+- Save macro-enabled workbook
+
+---
+
+# Common Mistakes
+
+❌ var workbook = new Workbook();
+✅ Workbook workbook = new Workbook();
+
+❌ Save macro workbook as output.xlsx
+✅ Save macro-enabled workbooks as output.xlsm
+
+❌ Workbook workbook = new Workbook("input.xlsm");
+✅ Workbook workbook = new Workbook();
+
+---
+
+# Code Simplicity
+
+- Keep examples concise
+- Avoid unnecessary abstractions
+- Focus on one VBA capability per example
+
+---
+
+# General Rules
+
+Refer to the root agents.md for:
+- Boundaries
+- Testing requirements
+- Build and run instructions

macro-project/apply-password-protection-only-when-the-workbook-contains-more-than-ten-worksheets-to-enforce-policy.cs

@@ -0,0 +1,37 @@
+using System;
+using Aspose.Cells;
+
+namespace AsposeCellsPasswordPolicy
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook
+            Workbook workbook = new Workbook();
+
+            // Add worksheets to demonstrate the condition (total 12 worksheets)
+            for (int i = 0; i < 12; i++)
+            {
+                // The first worksheet already exists; add new ones for the rest
+                if (i > 0)
+                    workbook.Worksheets.Add();
+                // Optionally put some data
+                workbook.Worksheets[i].Cells["A1"].PutValue($"Sheet {i + 1}");
+            }
+
+            // Apply password protection only if the workbook has more than ten worksheets
+            if (workbook.Worksheets.Count > 10)
+            {
+                // Protect the workbook structure with a password
+                workbook.Protect(ProtectionType.Structure, "StrongPassword!123");
+            }
+
+            // Save the workbook
+            workbook.Save("ProtectedIfMoreThanTenSheets.xlsx", SaveFormat.Xlsx);
+
+            // Clean up
+            workbook.Dispose();
+        }
+    }
+}