Publish lists category examples (#234)

Author: agent-aspose-words-examples

lists/AGENTS.md

@@ -213,7 +213,7 @@ Use the simplest workflow that satisfies the task.
 ## Build and run contract
 
 - Target framework: `net8.0`
-- Package: `Aspose.Words` `26.7.0`
+- Package: `Aspose.Words` `26.8.0`
 
 ## Command reference
 
@@ -227,7 +227,7 @@ cd ExampleProject
 ### Add required packages
 
 ```bash
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 ```
 
 ### Copy a category example into the temp project

lists/README.md

@@ -1,14 +1,14 @@
 # Lists Examples for Aspose.Words for .NET
 
-This folder contains the live, publish-ready C# examples for the Lists category. Each file is a standalone console example selected from the verified 26.7.0 run.
+This folder contains the live, publish-ready C# examples for the Lists category. Each file is a standalone console example selected from the verified 26.8.0 run.
 
 ## Snapshot
 
 - Category: Lists
 - Slug: lists
 - Total examples: 30
 - Publish-ready successful examples: 30 / 30
-- Source run: 20260802_190455_803b68
+- Source run: 20260830_195242_46e1a9
 - Numbered List Workflow examples: 2
 - Bulleted List Workflow examples: 1
 - Nested List Workflow examples: 17
@@ -31,7 +31,7 @@ This folder contains the live, publish-ready C# examples for the Lists category.
 ## Prerequisites
 
 - .NET SDK 8.0 or later
-- Aspose.Words 26.7.0
+- Aspose.Words 26.8.0
 
 ## Running Examples
 
@@ -40,7 +40,7 @@ Each file in this folder is a single, standalone `.cs` console example. To run o
 ```bash
 dotnet new console -n ExampleProject --framework net8.0
 cd ExampleProject
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 
 # Copy one example from this folder into the project as Program.cs
 # PowerShell:
@@ -61,7 +61,7 @@ Example:
 # From the repository root
 dotnet new console -n ExampleProject --framework net8.0
 cd ExampleProject
-dotnet add package Aspose.Words --version 26.7.0
+dotnet add package Aspose.Words --version 26.8.0
 
 # PowerShell example
 Copy-Item ..\lists\create-a-default-numbered-list-in-a-word-document-using-documentbuilder-listformat-applynu.cs .\Program.cs
@@ -138,6 +138,6 @@ dotnet run --configuration Release --no-build
 
 ## Notes for maintainers
 
-- This category is 100% publish-ready for the 26.7.0 run.
+- This category is 100% publish-ready for the 26.8.0 run.
 - Preserve file-to-task traceability when updating this folder.
 - Keep examples standalone and bootstrap local inputs inside the example whenever external sources are mentioned.

lists/add-a-new-list-to-the-document-s-listcollection-and-assign-it-to-multiple-paragraphs-to-sh.cs

@@ -6,28 +6,31 @@ public class Program
 {
     public static void Main()
     {
-        // Create a new blank document.
+        // Create a new empty document.
         Document doc = new Document();
         DocumentBuilder builder = new DocumentBuilder(doc);
 
         // Add a new list to the document's ListCollection using a predefined template.
         List sharedList = doc.Lists.Add(ListTemplate.BulletDefault);
 
-        // Apply the same list to multiple paragraphs.
-        builder.ListFormat.List = sharedList;
-        builder.ListFormat.ListLevelNumber = 0; // Use the first level of the list.
+        // Write a normal paragraph (no list formatting).
+        builder.Writeln("Paragraph without list.");
 
-        builder.Writeln("First shared list item");
-        builder.Writeln("Second shared list item");
-        builder.Writeln("Third shared list item");
+        // Add several paragraphs that share the same list formatting.
+        for (int i = 1; i <= 3; i++)
+        {
+            // Assign the shared list to the current paragraph.
+            builder.ListFormat.List = sharedList;
+            // Use the first level of the list (level 0).
+            builder.ListFormat.ListLevelNumber = 0;
+            builder.Writeln($"List item {i}");
+        }
 
-        // Stop list formatting for any following paragraphs.
-        builder.ListFormat.RemoveNumbers();
+        // Stop applying list formatting for any following paragraphs.
+        builder.ListFormat.List = null;
+        builder.Writeln("Paragraph after list.");
 
-        // Add a regular paragraph without list formatting.
-        builder.Writeln("A normal paragraph without list formatting.");
-
-        // Save the document to disk.
+        // Save the document to a file in the current directory.
         doc.Save("SharedListExample.docx");
     }
 }

lists/adjust-listlevel-indentation-by-setting-listlevel-indentation-to-36-points-for-proper-alig.cs

@@ -7,42 +7,39 @@ public class Program
 {
     public static void Main()
     {
-        // Create a new empty document.
+        // Create a new blank document.
         Document doc = new Document();
-
-        // Create a DocumentBuilder to insert content.
         DocumentBuilder builder = new DocumentBuilder(doc);
 
-        // Add a multi‑level list based on the built‑in NumberDefault template.
+        // Add a list based on the default numbered template.
         List list = doc.Lists.Add(ListTemplate.NumberDefault);
 
-        // Adjust the indentation of each list level to 36 points (0.5 inch).
+        // Adjust the indentation of the first two list levels to 36 points.
         // The ListLevel class does not have an Indentation property.
-        // Instead, set NumberPosition, TextPosition and TabPosition to control the left indent.
-        foreach (ListLevel level in list.ListLevels)
-        {
-            level.NumberPosition = 36.0; // Position of the number/bullet.
-            level.TextPosition = 36.0;   // Position where the text starts.
-            level.TabPosition = 36.0;    // Tab stop for the level.
-        }
+        // Use NumberPosition (position of the bullet/number) and TextPosition (position of the text)
+        // to achieve the desired left indent.
+        ListLevel level0 = list.ListLevels[0];
+        level0.NumberPosition = 36; // points
+        level0.TextPosition = 36;   // points
+
+        ListLevel level1 = list.ListLevels[1];
+        level1.NumberPosition = 36; // points
+        level1.TextPosition = 36;   // points
 
-        // Apply the list to the builder and add a few items.
+        // Apply the list to some paragraphs.
         builder.ListFormat.List = list;
-        builder.Writeln("First level item");
-        builder.ListFormat.ListIndent(); // Move to second level.
-        builder.Writeln("Second level item");
-        builder.ListFormat.ListIndent(); // Move to third level.
-        builder.Writeln("Third level item");
-        builder.ListFormat.ListOutdent(); // Back to second level.
-        builder.Writeln("Another second level item");
-        builder.ListFormat.RemoveNumbers(); // End the list.
+        builder.Writeln("Item 1");
+        builder.ListFormat.ListIndent();
+        builder.Writeln("Subitem 1");
+        builder.ListFormat.ListOutdent();
+        builder.Writeln("Item 2");
+        builder.ListFormat.RemoveNumbers();
 
         // Ensure the output directory exists.
         string artifactsDir = Path.Combine(Environment.CurrentDirectory, "Artifacts");
         Directory.CreateDirectory(artifactsDir);
 
         // Save the document.
-        string outputPath = Path.Combine(artifactsDir, "Lists.AdjustIndentation.docx");
-        doc.Save(outputPath);
+        doc.Save(Path.Combine(artifactsDir, "AdjustedListIndentation.docx"));
     }
 }

lists/apply-a-custom-bullet-character-to-a-list-by-setting-listlevel-numberstyle-to-bullet-and-d.cs

@@ -1,47 +1,44 @@
 using System;
-using System.IO;
 using Aspose.Words;
 using Aspose.Words.Lists;
+using System.Drawing;
 
 public class Program
 {
     public static void Main()
     {
-        // Create a new blank document.
+        // Create a new empty document.
         Document doc = new Document();
 
-        // Initialize a DocumentBuilder which will be used to insert content.
-        DocumentBuilder builder = new DocumentBuilder(doc);
-
         // Create a new list based on the default bullet template.
         List bulletList = doc.Lists.Add(ListTemplate.BulletDefault);
 
         // Access the first (top) level of the list.
         ListLevel level = bulletList.ListLevels[0];
 
-        // Set the list level to use a bullet style.
+        // Set the level to use a bullet style.
         level.NumberStyle = NumberStyle.Bullet;
 
-        // Define a custom bullet character (black circle in this case).
-        // The NumberFormat property holds the character that will be displayed as the bullet.
-        level.NumberFormat = "\u25CF"; // Unicode character: ●
+        // Define a custom bullet character (★ - black star).
+        level.NumberFormat = "\u2605";
 
-        // Optionally, set the font that contains the bullet glyph.
-        level.Font.Name = "Symbol";
+        // Optional: customize the appearance of the bullet.
+        level.Font.Name = "Arial";
+        level.Font.Size = 12;
+        level.Font.Color = Color.DarkBlue;
 
-        // Apply the custom list to the builder.
+        // Use a DocumentBuilder to add paragraphs that will use the custom bullet list.
+        DocumentBuilder builder = new DocumentBuilder(doc);
         builder.ListFormat.List = bulletList;
 
-        // Add some list items.
-        builder.Writeln("First custom bullet item");
-        builder.Writeln("Second custom bullet item");
-        builder.Writeln("Third custom bullet item");
+        builder.Writeln("First item with a custom bullet.");
+        builder.Writeln("Second item with a custom bullet.");
+        builder.Writeln("Third item with a custom bullet.");
 
-        // End the list.
+        // End the list formatting.
         builder.ListFormat.RemoveNumbers();
 
-        // Save the document to the current directory.
-        string outputPath = Path.Combine(Directory.GetCurrentDirectory(), "CustomBulletList.docx");
-        doc.Save(outputPath);
+        // Save the document to a file.
+        doc.Save("CustomBulletList.docx");
     }
 }

lists/apply-a-custom-tab-stop-to-list-levels-to-align-text-after-numbers-using-listlevel-tabposi.cs

@@ -8,29 +8,48 @@ public static void Main()
     {
         // Create a new blank document.
         Document doc = new Document();
+        DocumentBuilder builder = new DocumentBuilder(doc);
 
         // Add a numbered list based on the default template.
         List list = doc.Lists.Add(ListTemplate.NumberDefault);
 
         // Configure the first list level.
-        ListLevel level = list.ListLevels[0];
-        level.Font.Size = 12;                         // Font size for the number.
-        level.NumberStyle = NumberStyle.Arabic;       // Use Arabic numbers.
-        level.NumberFormat = "%1.";                   // Number format (e.g., "1.").
-        level.TrailingCharacter = ListTrailingCharacter.Tab; // Place a tab after the number.
-        level.NumberPosition = -18;                   // Position of the number (negative moves it left).
-        level.TextPosition = 36;                      // Position where the text starts.
-        level.TabPosition = 36;                       // Tab stop aligns the text after the number.
-
-        // Use DocumentBuilder to add list items.
-        DocumentBuilder builder = new DocumentBuilder(doc);
+        ListLevel level0 = list.ListLevels[0];
+        level0.Font.Color = System.Drawing.Color.DarkBlue;
+        level0.Font.Size = 12;
+        level0.NumberStyle = NumberStyle.Arabic;
+        level0.NumberFormat = "%1.";
+        level0.StartAt = 1;
+
+        // Position of the number (negative moves it left of the left indent).
+        level0.NumberPosition = -18;   // points
+        // Position where the text of the paragraph starts.
+        level0.TextPosition = 36;      // points
+        // Set a tab stop after the number so that the text aligns after the tab.
+        level0.TabPosition = 36;       // points
+        // Use a tab character as the separator between number and text.
+        level0.TrailingCharacter = ListTrailingCharacter.Tab;
+
+        // Apply the list to subsequent paragraphs.
         builder.ListFormat.List = list;
-        builder.Writeln("First item");
-        builder.Writeln("Second item");
-        builder.Writeln("Third item");
-        builder.ListFormat.RemoveNumbers(); // End the list.
 
-        // Save the document to a file.
-        doc.Save("CustomTabStopList.docx");
+        // First level items.
+        builder.Writeln("First level item 1");
+        builder.Writeln("First level item 2");
+
+        // Increase list level (second level).
+        builder.ListFormat.ListIndent();
+        builder.Writeln("Second level item 1");
+        builder.Writeln("Second level item 2");
+
+        // Decrease back to first level.
+        builder.ListFormat.ListOutdent();
+        builder.Writeln("First level item 3");
+
+        // Remove list formatting.
+        builder.ListFormat.RemoveNumbers();
+
+        // Save the document to disk.
+        doc.Save("CustomTabList.docx");
     }
 }

lists/apply-a-default-bulleted-list-to-paragraphs-with-documentbuilder-listformat-applybulletdef.cs

@@ -1,43 +1,35 @@
 using System;
 using System.IO;
 using Aspose.Words;
-using Aspose.Words.Lists;
 
-namespace AsposeWordsListsExample
+public class Program
 {
-    public class Program
+    public static void Main()
     {
-        public static void Main()
-        {
-            // Create a new blank document.
-            Document doc = new Document();
+        // Create a new blank document.
+        Document doc = new Document();
 
-            // Attach a DocumentBuilder to the document.
-            DocumentBuilder builder = new DocumentBuilder(doc);
+        // Attach a DocumentBuilder to the document.
+        DocumentBuilder builder = new DocumentBuilder(doc);
 
-            // Write a heading before the list.
-            builder.Writeln("Default bulleted list example:");
+        // Write a heading before the list.
+        builder.Writeln("Aspose.Words main advantages are:");
 
-            // Start a default bulleted list and apply it to subsequent paragraphs.
-            builder.ListFormat.ApplyBulletDefault();
+        // Start a default bulleted list.
+        builder.ListFormat.ApplyBulletDefault();
 
-            // Add several list items.
-            builder.Writeln("First bullet item");
-            builder.Writeln("Second bullet item");
-            builder.Writeln("Third bullet item");
-            builder.Writeln("Fourth bullet item");
-            builder.Writeln("Fifth bullet item");
+        // Add list items that will be formatted with bullets.
+        builder.Writeln("High performance");
+        builder.Writeln("Robust API");
+        builder.Writeln("Cross‑platform support");
+        builder.Writeln("Extensive format conversion");
+        builder.Writeln("Easy to use");
 
-            // End the list.
-            builder.ListFormat.RemoveNumbers();
+        // End the bulleted list.
+        builder.ListFormat.RemoveNumbers();
 
-            // Define the output folder and file name.
-            string outputDir = Path.Combine(Environment.CurrentDirectory, "Output");
-            Directory.CreateDirectory(outputDir);
-            string outputPath = Path.Combine(outputDir, "DefaultBulletedList.docx");
-
-            // Save the document to the specified path.
-            doc.Save(outputPath);
-        }
+        // Save the document to the current working directory.
+        string outputPath = Path.Combine(Environment.CurrentDirectory, "DefaultBulletedList.docx");
+        doc.Save(outputPath);
     }
 }