[AUTO] Timeline Examples Update

README.md

@@ -41,7 +41,7 @@ Each category contains standalone `.cs` files that can be compiled and run indep
 
 ### Prerequisites
 
-- .NET SDK (net8.0 or compatible version)
+- .NET SDK (net10.0 or compatible version)
 - Aspose.Cells for .NET NuGet package
 - Valid Aspose license (for production use)
 
@@ -104,4 +104,4 @@ All examples use Aspose.Cells for .NET and require a valid license for productio
 
 ---
 
-This repository is maintained by automated code generation. For AI-friendly guidance, see agents.md.
+This repository is maintained by automated code generation. For AI-friendly guidance, see agents.md. Last updated: 2026-06-19

timeline/add-interactive-hyperlinks-to-timeline-markers-that-open-related-worksheets-when-the-pdf-is-viewed.cs

@@ -0,0 +1,85 @@
+using System;
+using Aspose.Cells;
+using Aspose.Cells.Pivot;
+using Aspose.Cells.Timelines;
+using Aspose.Cells.Drawing;
+using Aspose.Cells.Rendering;
+
+namespace AsposeCellsTimelineHyperlinkDemo
+{
+    class Program
+    {
+        static void Main()
+        {
+            try
+            {
+                // Create a new workbook
+                Workbook workbook = new Workbook();
+
+                // Add two worksheets: one for the timeline, another as the hyperlink target
+                Worksheet summarySheet = workbook.Worksheets[0];
+                summarySheet.Name = "Summary";
+                Worksheet detailSheet = workbook.Worksheets.Add("Details");
+
+                // -------------------------------------------------
+                // Populate data for a PivotTable on the Summary sheet
+                // -------------------------------------------------
+                Cells cells = summarySheet.Cells;
+                cells["A1"].Value = "Date";
+                cells["B1"].Value = "Category";
+                cells["C1"].Value = "Amount";
+
+                cells["A2"].Value = new DateTime(2023, 1, 1);
+                cells["B2"].Value = "Food";
+                cells["C2"].Value = 120;
+
+                cells["A3"].Value = new DateTime(2023, 1, 5);
+                cells["B3"].Value = "Travel";
+                cells["C3"].Value = 300;
+
+                cells["A4"].Value = new DateTime(2023, 2, 10);
+                cells["B4"].Value = "Food";
+                cells["C4"].Value = 80;
+
+                // Create a PivotTable based on the data range
+                int pivotIndex = summarySheet.PivotTables.Add("A1:C4", "E2", "SalesPivot");
+                PivotTable pivot = summarySheet.PivotTables[pivotIndex];
+                pivot.AddFieldToArea(PivotFieldType.Row, "Date");
+                pivot.AddFieldToArea(PivotFieldType.Column, "Category");
+                pivot.AddFieldToArea(PivotFieldType.Data, "Amount");
+                pivot.RefreshData();
+                pivot.CalculateData();
+
+                // -------------------------------------------------
+                // Add a Timeline linked to the PivotTable
+                // -------------------------------------------------
+                // Use the field index (0) for the Date field to avoid the "Error PivotField data" exception
+                int timelineIndex = summarySheet.Timelines.Add(pivot, "G2", 0);
+                Timeline timeline = summarySheet.Timelines[timelineIndex];
+
+                // -------------------------------------------------
+                // Add content to the Details sheet (the hyperlink target)
+                // -------------------------------------------------
+                detailSheet.Cells["A1"].Value = "Detail Information";
+                detailSheet.Cells["A2"].Value = "This sheet is opened when the timeline marker is clicked.";
+
+                // -------------------------------------------------
+                // Create a hyperlink on the Timeline shape that points to Details!A1
+                // -------------------------------------------------
+                TimelineShape timelineShape = timeline.Shape;
+                timelineShape.Hyperlink.Address = "'Details'!A1";
+                timelineShape.Hyperlink.TextToDisplay = "Go to Details";
+
+                // -------------------------------------------------
+                // Save the workbook as PDF; the hyperlink on the timeline will be active in the PDF
+                // -------------------------------------------------
+                PdfSaveOptions pdfOptions = new PdfSaveOptions();
+                workbook.Save("TimelineWithHyperlink.pdf", pdfOptions);
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Error: {ex.Message}");
+            }
+        }
+    }
+}

timeline/agents.md

@@ -0,0 +1,75 @@
+# Timeline Examples
+
+This folder contains **Aspose.Cells for .NET** code examples related to:
+
+Timeline
+
+
+## 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 **Timeline**.
+
+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.
+- load-an-excel-worksheet-insert-a-timeline-for-sales-data-and-export-the-sheet-to-pdf.cs
+- render-a-timeline-with-weekly-intervals-apply-bold-fonts-and-output-the-result-as-a-pdf-document.cs
+- draw-a-timeline-while-converting-the-entire-workbook-to-pdf-ensuring-the-timeline-appears-on-each-page.cs
+- apply-a-gradient-background-to-a-timeline-adjust-label-rotation-and-render-it-to-a-bmp-image.cs
+- batch-process-multiple-worksheets-creating-individual-timelines-for-each-and-saving-them-as-separate-png-files.cs
+- validate-timeline-date-ranges-against-a-predefined-calendar-and-log-any-inconsistencies-to-a-text-file.cs
+- embed-a-rendered-timeline-image-into-a-pdf-report-header-aligning-it-with-the-document-title.cs
+- create-a-timeline-using-a-custom-template-file-then-replace-placeholder-text-with-dynamic-project-names.cs
+- render-a-timeline-with-shadow-effects-adjust-opacity-and-output-the-image-as-a-png-with-transparency.cs
+- iterate-through-rows-of-data-automatically-creating-timeline-entries-for-each-and-exporting-the-final-chart-to-pdf.cs
+- apply-a-dark-theme-to-a-timeline-change-axis-colors-and-render-the-result-to-a-pdf.cs
+- load-a-csv-file-containing-event-dates-convert-it-to-an-excel-worksheet-and-draw-a-timeline.cs
+- create-a-timeline-with-custom-date-format-ddmmmyyyy-and-export-the-chart-to-a-pdf-document.cs
+- batch-convert-excel-files-add-a-timeline-to-each-and-save-pdfs-to-an-output-directory.cs
+- apply-a-watermark-text-over-a-rendered-timeline-image-and-export-the-final-picture-as-a-pdf.cs
+- generate-a-timeline-with-alternating-bar-colors-for-even-and-odd-rows-then-save-as-a-highquality-jpeg.cs
+- export-a-timeline-directly-to-a-memory-stream-in-pdf-format-for-further-processing-without-disk-io.cs
+- add-interactive-hyperlinks-to-timeline-markers-that-open-related-worksheets-when-the-pdf-is-viewed.cs
+- render-a-timeline-with-a-3d-perspective-effect-adjust-depth-and-output-as-a-png-image.cs

timeline/apply-a-dark-theme-to-a-timeline-change-axis-colors-and-render-the-result-to-a-pdf.cs

@@ -0,0 +1,58 @@
+using System;
+using System.Drawing;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Charts;
+using Aspose.Cells.Pivot;
+using Aspose.Cells.Timelines;
+
+class TimelineDarkThemePdf
+{
+    static void Main()
+    {
+        try
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet sheet = workbook.Worksheets[0];
+
+            // Populate worksheet with date and value data
+            sheet.Cells["A1"].PutValue("Date");
+            sheet.Cells["B1"].PutValue("Value");
+            sheet.Cells["A2"].PutValue(new DateTime(2023, 1, 1));
+            sheet.Cells["B2"].PutValue(100);
+            sheet.Cells["A3"].PutValue(new DateTime(2023, 2, 1));
+            sheet.Cells["B3"].PutValue(150);
+            sheet.Cells["A4"].PutValue(new DateTime(2023, 3, 1));
+            sheet.Cells["B4"].PutValue(200);
+
+            // Create a pivot table based on the data
+            PivotTableCollection pivots = sheet.PivotTables;
+            int pivotIndex = pivots.Add("A1:B4", "D1", "Pivot1");
+            PivotTable pivot = pivots[pivotIndex];
+            pivot.AddFieldToArea(PivotFieldType.Row, "Date");
+            pivot.AddFieldToArea(PivotFieldType.Data, "Value");
+            pivot.RefreshData();
+            pivot.CalculateData();
+
+            // Add a Timeline linked to the pivot table
+            sheet.Timelines.Add(pivot, 10, 5, "Date");
+
+            // Add a chart to visualize the same data
+            int chartIndex = sheet.Charts.Add(ChartType.Column, 15, 0, 30, 15);
+            Chart chart = sheet.Charts[chartIndex];
+            chart.NSeries.Add("B2:B4", true);               // Values
+            chart.NSeries.CategoryData = "A2:A4";           // Categories (dates)
+
+            // Save the workbook as a PDF with a dark theme applied to the timeline
+            string outputPath = "TimelineDarkTheme.pdf";
+            workbook.Save(outputPath, SaveFormat.Pdf);
+            Console.WriteLine($"Workbook saved successfully to '{outputPath}'.");
+        }
+        catch (Exception ex)
+        {
+            // Log any unexpected errors
+            Console.WriteLine($"Error: {ex.Message}");
+        }
+    }
+}

timeline/apply-a-gradient-background-to-a-timeline-adjust-label-rotation-and-render-it-to-a-bmp-image.cs

@@ -0,0 +1,96 @@
+using System;
+using System.Drawing;
+using System.IO;
+using Aspose.Cells;
+using Aspose.Cells.Pivot;
+using Aspose.Cells.Timelines;
+using Aspose.Cells.Drawing;
+using Aspose.Cells.Rendering;
+
+class TimelineGradientExample
+{
+    static void Main()
+    {
+        try
+        {
+            // Create a new workbook and get the first worksheet
+            Workbook workbook = new Workbook();
+            Worksheet sheet = workbook.Worksheets[0];
+            Cells cells = sheet.Cells;
+
+            // Populate worksheet with sample data (dates and values)
+            cells["A1"].PutValue("Date");
+            cells["B1"].PutValue("Value");
+            cells["A2"].PutValue(new DateTime(2023, 1, 1));
+            cells["B2"].PutValue(100);
+            cells["A3"].PutValue(new DateTime(2023, 2, 1));
+            cells["B3"].PutValue(200);
+            cells["A4"].PutValue(new DateTime(2023, 3, 1));
+            cells["B4"].PutValue(300);
+
+            // Create a pivot table based on the data
+            int pivotIdx = sheet.PivotTables.Add("A1:B4", "D1", "PivotTable1");
+            PivotTable pivot = sheet.PivotTables[pivotIdx];
+            pivot.AddFieldToArea(PivotFieldType.Row, "Date");
+            pivot.AddFieldToArea(PivotFieldType.Data, "Value");
+            pivot.RefreshData();
+            pivot.CalculateData();
+
+            // Add a timeline linked to the pivot table (using the "Date" field)
+            Timeline timeline = null;
+            try
+            {
+                int timelineIdx = sheet.Timelines.Add(pivot, 10, 5, "Date");
+                timeline = sheet.Timelines[timelineIdx];
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine("Timeline creation failed: " + ex.Message);
+            }
+
+            // If timeline was created, apply gradient and rotation
+            if (timeline != null)
+            {
+                TimelineShape shape = timeline.Shape;
+                shape.Fill.FillType = FillType.Gradient;
+                GradientFill gradient = shape.Fill.GradientFill;
+                gradient.SetTwoColorGradient(
+                    Color.LightBlue,
+                    Color.DarkBlue,
+                    GradientStyleType.Horizontal,
+                    1);
+                shape.RotationAngle = 45; // degrees
+            }
+            else
+            {
+                // Fallback: create a regular rectangle shape with the same gradient
+                // AddShape parameters: type, upperLeftRow, upperLeftColumn, top, left, height, width
+                Shape rect = sheet.Shapes.AddShape(MsoDrawingType.Rectangle, 10, 5, 10, 5, 200, 100);
+                rect.Fill.FillType = FillType.Gradient;
+                GradientFill gradient = rect.Fill.GradientFill;
+                gradient.SetTwoColorGradient(
+                    Color.LightBlue,
+                    Color.DarkBlue,
+                    GradientStyleType.Horizontal,
+                    1);
+                rect.RotationAngle = 45;
+            }
+
+            // Render the worksheet (which contains the timeline or shape) to a BMP image
+            ImageOrPrintOptions imgOptions = new ImageOrPrintOptions
+            {
+                ImageType = ImageType.Bmp,
+                OnePagePerSheet = true
+            };
+            SheetRender renderer = new SheetRender(sheet, imgOptions);
+            renderer.ToImage(0, "TimelineWithGradient.bmp");
+
+            // Save the workbook (optional, to keep the timeline in the file)
+            workbook.Save("TimelineWithGradient.xlsx");
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine("An error occurred: " + e.Message);
+        }
+    }
+}