[AUTO] Working With Shapes Examples Update

working-with-shapes/access-connection-points-of-shape-flowconnector-and-attach-them-to-cells-a1-and-b2-for-dynamic-linking.cs

@@ -0,0 +1,49 @@
+using System;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+namespace AsposeCellsFlowConnectorDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet worksheet = workbook.Worksheets[0];
+
+                // Add a straight line shape (used as a connector) to the worksheet
+                // Parameters: upper left row, upper left column, upper left pixel offset,
+                // lower right row, lower right column, lower right pixel offset
+                Shape flowConnector = worksheet.Shapes.AddLine(
+                    2, 2, 0,   // start at cell C3 (row 2, column 2)
+                    5, 5, 0);  // end at cell F6 (row 5, column 5)
+
+                // Retrieve the connection points of the shape
+                float[][] connectionPoints = flowConnector.GetConnectionPoints();
+
+                // Output the connection points for verification
+                Console.WriteLine("Connector Connection Points:");
+                for (int i = 0; i < connectionPoints.Length; i++)
+                {
+                    Console.WriteLine($"Point {i + 1}: X = {connectionPoints[i][0]}, Y = {connectionPoints[i][1]}");
+                }
+
+                // Link the shape to a worksheet cell (example)
+                flowConnector.SetLinkedCell("$A$1", false, true);
+
+                // Save the workbook
+                string outputPath = "FlowConnectorDemo.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved to {Path.GetFullPath(outputPath)}");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

working-with-shapes/access-nonprimitive-shape-data-and-extract-all-path-segment-points.cs

@@ -0,0 +1,56 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+class ExtractShapePathPoints
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet worksheet = workbook.Worksheets[0];
+
+        // Build a simple freeform shape (rectangle) using ShapePath commands
+        ShapePath shapePath = new ShapePath();
+        shapePath.MoveTo(10, 10);
+        shapePath.LineTo(200, 10);
+        shapePath.LineTo(200, 100);
+        shapePath.LineTo(10, 100);
+        shapePath.Close();
+
+        // Add the freeform shape to the worksheet
+        worksheet.Shapes.AddFreeform(1, 0, 1, 0, 300, 200, new ShapePath[] { shapePath });
+
+        // Retrieve the shape we just added (first shape in the collection)
+        Shape shape = worksheet.Shapes[0];
+
+        // Cast the shape's geometry to CustomGeometry to access path information
+        CustomGeometry geometry = shape.Geometry as CustomGeometry;
+        if (geometry != null)
+        {
+            // Iterate through each ShapePath in the geometry
+            for (int pathIndex = 0; pathIndex < geometry.Paths.Count; pathIndex++)
+            {
+                ShapePath path = geometry.Paths[pathIndex];
+
+                // Iterate through each segment in the current ShapePath
+                for (int segIndex = 0; segIndex < path.PathSegementList.Count; segIndex++)
+                {
+                    ShapeSegmentPath segment = path.PathSegementList[segIndex];
+                    Console.WriteLine($"Path {pathIndex}, Segment {segIndex}, Type: {segment.Type}, Points: {segment.Points.Count}");
+
+                    // Iterate through all points in the current segment
+                    for (int ptIndex = 0; ptIndex < segment.Points.Count; ptIndex++)
+                    {
+                        ShapePathPoint point = segment.Points[ptIndex];
+                        // Use pixel coordinates for readability
+                        Console.WriteLine($"  Point {ptIndex}: X = {point.XPixel}, Y = {point.YPixel}");
+                    }
+                }
+            }
+        }
+
+        // Save the workbook
+        workbook.Save("ExtractShapePathPoints.xlsx");
+    }
+}

working-with-shapes/access-the-newly-added-activex-control-via-shapeactivexcontrol-and-cast-it-to-its-specific-type.cs

@@ -0,0 +1,64 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+using Aspose.Cells.Drawing.ActiveXControls;
+
+namespace AsposeCellsExamples
+{
+    public class AccessActiveXControlDemo
+    {
+        public static void Run()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet worksheet = workbook.Worksheets[0];
+
+                // Add a CheckBox ActiveX control to the worksheet
+                Shape shape = worksheet.Shapes.AddActiveXControl(
+                    ControlType.CheckBox, // type of control
+                    1,    // topRow index
+                    0,    // vertical offset in pixels
+                    1,    // leftColumn index
+                    0,    // horizontal offset in pixels
+                    100,  // width in pixels
+                    30    // height in pixels
+                );
+
+                // Verify that the control was added
+                if (shape.ActiveXControl != null)
+                {
+                    // Cast the generic ActiveXControl to its specific type
+                    CheckBoxActiveXControl checkBox = (CheckBoxActiveXControl)shape.ActiveXControl;
+
+                    // Access a property specific to CheckBoxActiveXControl
+                    string fontName = checkBox.Font.Name;
+                    Console.WriteLine($"CheckBox Font Name: {fontName}");
+
+                    // Modify some properties of the CheckBox
+                    checkBox.Caption = "Accept Terms";
+                    checkBox.IsEnabled = true;
+                }
+
+                // Save the workbook to a file
+                string outputPath = "AccessActiveXControlDemo.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved to {outputPath}");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+
+    // Entry point for the application
+    public class Program
+    {
+        public static void Main(string[] args)
+        {
+            AccessActiveXControlDemo.Run();
+        }
+    }
+}

working-with-shapes/access-the-shapes-textbody-and-obtain-the-shapetextalignment-object-for-formatting.cs

@@ -0,0 +1,31 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+using Aspose.Cells.Drawing.Texts;
+
+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 rectangle shape to the worksheet
+        Shape shape = worksheet.Shapes.AddRectangle(1, 0, 1, 0, 100, 50);
+        shape.Text = "Sample Text";
+
+        // Access the ShapeTextAlignment object via the shape's TextBody
+        ShapeTextAlignment textAlignment = shape.TextBody.TextAlignment;
+
+        // Example formatting: enable text wrapping and set custom margins
+        textAlignment.IsTextWrapped = true;
+        textAlignment.TopMarginPt = 12.0;
+        textAlignment.BottomMarginPt = 12.0;
+        textAlignment.LeftMarginPt = 6.0;
+        textAlignment.RightMarginPt = 6.0;
+
+        // Save the workbook
+        workbook.Save("ShapeTextAlignmentDemo.xlsx");
+    }
+}

working-with-shapes/add-a-checkbox-control-to-a-worksheet-and-link-its-state-to-cell-b2.cs

@@ -0,0 +1,30 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+class AddCheckBoxLinkedToCell
+{
+    static void Main()
+    {
+        // Create a new workbook and get the first worksheet
+        Workbook workbook = new Workbook();
+        Worksheet sheet = workbook.Worksheets[0];
+
+        // Add a CheckBox to the worksheet
+        // Parameters: upper left row, upper left column, height (pixels), width (pixels)
+        int checkBoxIndex = sheet.CheckBoxes.Add(5, 5, 20, 100);
+        CheckBox checkBox = sheet.CheckBoxes[checkBoxIndex];
+
+        // Set the display text of the CheckBox
+        checkBox.Text = "Accept Terms";
+
+        // Link the CheckBox state to cell B2
+        checkBox.LinkedCell = "B2";
+
+        // Optionally set the initial checked state
+        checkBox.Value = true;
+
+        // Save the workbook to a file
+        workbook.Save("CheckBoxLinked.xlsx");
+    }
+}

working-with-shapes/add-a-glowing-outer-border-to-a-picture-shape-using-specified-glow-radius-and-color-value.cs

@@ -0,0 +1,55 @@
+using System;
+using System.Drawing;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+namespace AddGlowToPictureApp
+{
+    class AddGlowToPicture
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook
+                Workbook workbook = new Workbook();
+                Worksheet sheet = workbook.Worksheets[0];
+
+                string imagePath = "sampleImage.jpg";
+
+                // Ensure the image file exists before adding it
+                if (!File.Exists(imagePath))
+                {
+                    Console.WriteLine($"Image file '{imagePath}' not found. Skipping picture insertion.");
+                }
+                else
+                {
+                    // Add the picture to the worksheet
+                    int pictureIndex = sheet.Pictures.Add(2, 2, imagePath);
+                    Picture picture = sheet.Pictures[pictureIndex];
+
+                    // Optional border for visibility
+                    picture.BorderLineColor = Color.Black;
+                    picture.BorderWeight = 1.0; // 1 pt
+
+                    // Apply glow effect
+                    GlowEffect glow = picture.Glow;
+                    CellsColor glowColor = workbook.CreateCellsColor();
+                    glowColor.Color = Color.FromArgb(255, 255, 0, 0); // Red glow
+                    glow.Color = glowColor;
+                    glow.Size = 12;            // Glow radius in points
+                    glow.Transparency = 0.3;   // 30% transparent
+                }
+
+                // Save the workbook
+                workbook.Save("PictureWithGlow.xlsx");
+                Console.WriteLine("Workbook saved successfully.");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

working-with-shapes/add-a-hyperlink-to-an-ole-object-that-opens-the-original-source-file-when-clicked.cs

@@ -0,0 +1,52 @@
+using System;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+namespace AddOleObjectWithHyperlinkDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook and get the first worksheet
+                Workbook workbook = new Workbook();
+                Worksheet sheet = workbook.Worksheets[0];
+
+                // Path to the source file that will be linked and opened via hyperlink
+                string sourceFilePath = "sample.docx";
+
+                // Ensure the source file exists before proceeding
+                if (!File.Exists(sourceFilePath))
+                {
+                    Console.WriteLine($"Source file not found: {sourceFilePath}");
+                    return;
+                }
+
+                // Read the file bytes to use as the OLE object's image (icon)
+                byte[] imageData = File.ReadAllBytes(sourceFilePath);
+
+                // Add a linked OLE object (topRow, leftColumn, height, width, imageData, linkedFile)
+                int oleIndex = sheet.OleObjects.Add(5, 2, 200, 300, imageData, sourceFilePath);
+
+                // Retrieve the added OleObject and mark it as a link
+                OleObject ole = sheet.OleObjects[oleIndex];
+                ole.IsLink = true;
+
+                // Set the hyperlink address (Hyperlink property is read‑only; modify its Address)
+                ole.Hyperlink.Address = sourceFilePath;
+
+                // Save the workbook
+                string outputPath = "OleObjectWithHyperlink.xlsx";
+                workbook.Save(outputPath);
+                Console.WriteLine($"Workbook saved to {outputPath}");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

working-with-shapes/add-a-hyperlink-to-the-textbox-that-opens-a-web-page-when-the-shape-is-clicked.cs

@@ -0,0 +1,27 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Drawing;
+
+namespace AsposeCellsHyperlinkExample
+{
+    class Program
+    {
+        static void Main()
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet sheet = workbook.Worksheets[0];
+
+            // Add a TextBox shape to the worksheet
+            // Parameters: upper left row, upper left column, top offset, left offset, width, height
+            TextBox textBox = sheet.Shapes.AddTextBox(2, 2, 10, 10, 200, 50);
+            textBox.Text = "Click here to visit Aspose";
+
+            // Add a hyperlink to the TextBox that opens a web page when clicked
+            textBox.AddHyperlink("https://www.aspose.com/");
+
+            // Save the workbook to a file
+            workbook.Save("TextBoxWithHyperlink.xlsx");
+        }
+    }
+}