Publish fonts category examples (#228)

Author: agent-aspose-words-examples

fonts/AGENTS.md

@@ -243,7 +243,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`
 - Package: `Aspose.Drawing.Common` `25.11.0`
 
 ## Command reference
@@ -258,7 +258,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
 dotnet add package Aspose.Drawing.Common --version 25.11.0
 ```
 

fonts/README.md

@@ -1,14 +1,14 @@
 # Fonts Examples for Aspose.Words for .NET
 
-This folder contains the live, publish-ready C# examples for the Fonts 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 Fonts category. Each file is a standalone console example selected from the verified 26.8.0 run.
 
 ## Snapshot
 
 - Category: Fonts
 - Slug: fonts
 - Total examples: 35
 - Publish-ready successful examples: 35 / 35
-- Source run: 20260802_190455_803b68
+- Source run: 20260830_195242_46e1a9
 - Document Formatting examples: 27
 - Font Settings And Sources examples: 4
 - Embedding And Rendering examples: 2
@@ -29,7 +29,7 @@ This folder contains the live, publish-ready C# examples for the Fonts category.
 ## Prerequisites
 
 - .NET SDK 8.0 or later
-- Aspose.Words 26.7.0
+- Aspose.Words 26.8.0
 - Aspose.Drawing.Common 25.11.0
 
 ## Running Examples
@@ -39,7 +39,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
 dotnet add package Aspose.Drawing.Common --version 25.11.0
 
 # Copy one example from this folder into the project as Program.cs
@@ -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
 dotnet add package Aspose.Drawing.Common --version 25.11.0
 
 # PowerShell example
@@ -149,6 +149,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.

fonts/adjust-a-paragraph-s-line-spacing-to-1-5-lines-by-assigning-font-linespacing-to-1-5.cs

@@ -12,30 +12,29 @@ public static void Main()
 
         // Use DocumentBuilder to add content.
         DocumentBuilder builder = new DocumentBuilder(doc);
-        builder.Writeln("This paragraph will have 1.5 line spacing.");
 
-        // Set the line spacing rule to Multiple (number of lines) and specify 1.5 lines.
-        // One line equals 12 points, so 1.5 lines = 18 points.
+        // Set the paragraph line spacing to 1.5 lines.
+        // In Aspose.Words, 1 line = 12 points. 1.5 lines = 18 points.
         builder.ParagraphFormat.LineSpacingRule = LineSpacingRule.Multiple;
-        builder.ParagraphFormat.LineSpacing = 18.0;
+        builder.ParagraphFormat.LineSpacing = 18; // points
 
-        // Validate that the line spacing was applied.
-        double appliedSpacing = builder.ParagraphFormat.LineSpacing;
-        if (Math.Abs(appliedSpacing - 18.0) > 0.001)
-        {
-            throw new InvalidOperationException("Line spacing was not set correctly.");
-        }
+        // Add a sample paragraph.
+        builder.Writeln("This paragraph uses 1.5 line spacing.");
 
-        // Define output file path.
+        // Define the output file path.
         string outputPath = Path.Combine(Directory.GetCurrentDirectory(), "ParagraphLineSpacing.docx");
 
         // Save the document.
         doc.Save(outputPath);
 
-        // Ensure the file was created.
-        if (!File.Exists(outputPath))
+        // Validate that the file was created.
+        if (File.Exists(outputPath))
+        {
+            Console.WriteLine("Document saved successfully: " + outputPath);
+        }
+        else
         {
-            throw new FileNotFoundException("The document was not saved correctly.", outputPath);
+            Console.WriteLine("Failed to save the document.");
         }
     }
 }

fonts/adjust-font-color-dynamically-based-on-paragraph-index-using-a-loop-and-conditional-logic.cs

@@ -1,7 +1,7 @@
 using System;
 using System.IO;
 using Aspose.Words;
-using Aspose.Drawing; // Provides Aspose.Drawing.Color
+using Aspose.Drawing;
 
 public class Program
 {
@@ -11,43 +11,41 @@ public static void Main()
         Document doc = new Document();
         DocumentBuilder builder = new DocumentBuilder(doc);
 
-        // Define a few Aspose.Drawing colors to choose from.
-        Aspose.Drawing.Color redAspose = Aspose.Drawing.Color.Red;
-        Aspose.Drawing.Color greenAspose = Aspose.Drawing.Color.Green;
+        // Define two colors using Aspose.Drawing.Color.
         Aspose.Drawing.Color blueAspose = Aspose.Drawing.Color.Blue;
+        Aspose.Drawing.Color redAspose = Aspose.Drawing.Color.Red;
+
+        // Convert Aspose.Drawing.Color to System.Drawing.Color for the Font.Color property.
+        System.Drawing.Color blue = System.Drawing.Color.FromArgb(blueAspose.ToArgb());
+        System.Drawing.Color red = System.Drawing.Color.FromArgb(redAspose.ToArgb());
 
         // Add several paragraphs, changing the font color based on the paragraph index.
         for (int i = 0; i < 5; i++)
         {
-            // Select a color using conditional logic.
-            Aspose.Drawing.Color selectedAsposeColor;
-            if (i % 3 == 0)
-                selectedAsposeColor = redAspose;
-            else if (i % 3 == 1)
-                selectedAsposeColor = greenAspose;
-            else
-                selectedAsposeColor = blueAspose;
+            // Even index -> blue, odd index -> red.
+            System.Drawing.Color currentColor = (i % 2 == 0) ? blue : red;
 
-            // Convert Aspose.Drawing.Color to System.Drawing.Color as required by Font.Color.
-            System.Drawing.Color sysColor = System.Drawing.Color.FromArgb(selectedAsposeColor.ToArgb());
+            // Apply the selected color to the builder's font.
+            builder.Font.Color = currentColor;
 
-            // Apply the color to the current font.
-            builder.Font.Color = sysColor;
-
-            // Write a paragraph.
-            builder.Writeln($"Paragraph {i + 1} with dynamically set color.");
+            // Write the paragraph text.
+            builder.Writeln($"Paragraph {i + 1} with {(i % 2 == 0 ? "blue" : "red")} text.");
 
             // Validate that the color was set correctly.
-            if (builder.Font.Color.ToArgb() != sysColor.ToArgb())
-                throw new InvalidOperationException("Font color was not applied as expected.");
+            if (builder.Font.Color.ToArgb() != currentColor.ToArgb())
+                throw new InvalidOperationException("Font color assignment validation failed.");
         }
 
-        // Save the document to the current directory.
-        string outputPath = Path.Combine(Directory.GetCurrentDirectory(), "DynamicFontColors.docx");
+        // Ensure the output directory exists.
+        string outputDir = Path.Combine(Directory.GetCurrentDirectory(), "Output");
+        Directory.CreateDirectory(outputDir);
+        string outputPath = Path.Combine(outputDir, "DynamicFontColors.docx");
+
+        // Save the document.
         doc.Save(outputPath);
 
-        // Ensure the file was created.
+        // Verify that the file was created.
         if (!File.Exists(outputPath))
-            throw new FileNotFoundException("The document was not saved correctly.", outputPath);
+            throw new FileNotFoundException("Document was not saved correctly.", outputPath);
     }
 }

fonts/apply-a-predefined-style-that-includes-specific-font-settings-to-a-range-of-paragraphs.cs

@@ -1,11 +1,6 @@
 using System;
 using System.IO;
-using System.Diagnostics;
 using Aspose.Words;
-using Aspose.Words.Fonts;
-using Aspose.Words.Drawing;
-using Aspose.Words.Themes;
-using Aspose.Words.Saving;
 using Aspose.Drawing;
 
 public class Program
@@ -16,42 +11,27 @@ public static void Main()
         Document doc = new Document();
         DocumentBuilder builder = new DocumentBuilder(doc);
 
-        // Create a custom paragraph style named "MyCustomStyle".
+        // Define a custom paragraph style with specific font settings.
         Style customStyle = doc.Styles.Add(StyleType.Paragraph, "MyCustomStyle");
-
-        // Define specific font settings for the style.
         customStyle.Font.Name = "Arial";
         customStyle.Font.Size = 14;
-        customStyle.Font.Bold = true;
-
-        // Create a color using Aspose.Drawing, then convert to System.Drawing.Color.
-        Aspose.Drawing.Color aspColor = Aspose.Drawing.Color.Blue;
-        System.Drawing.Color sysColor = System.Drawing.Color.FromArgb(aspColor.ToArgb());
 
+        // Create a color using Aspose.Drawing.Color and convert it to System.Drawing.Color.
+        Aspose.Drawing.Color asposeColor = Aspose.Drawing.Color.Blue;
+        System.Drawing.Color sysColor = System.Drawing.Color.FromArgb(asposeColor.ToArgb());
         customStyle.Font.Color = sysColor;
 
         // Apply the custom style to a range of paragraphs.
         builder.ParagraphFormat.Style = customStyle;
-        builder.Writeln("Paragraph 1 with custom style.");
-        builder.Writeln("Paragraph 2 with custom style.");
-        builder.Writeln("Paragraph 3 with custom style.");
+        builder.Writeln("First paragraph with custom style.");
+        builder.Writeln("Second paragraph with custom style.");
 
-        // Switch back to the default "Normal" style for subsequent paragraphs.
+        // Add a normal paragraph without the custom style.
         builder.ParagraphFormat.Style = doc.Styles["Normal"];
-        builder.Writeln("Paragraph 4 with normal style.");
+        builder.Writeln("A normal paragraph without custom style.");
 
-        // Validate that the style's font properties are set correctly.
-        Debug.Assert(customStyle.Font.Name == "Arial");
-        Debug.Assert(customStyle.Font.Size == 14);
-        Debug.Assert(customStyle.Font.Bold == true);
-        Debug.Assert(customStyle.Font.Color.ToArgb() == sysColor.ToArgb());
-
-        // Save the document to a file.
-        string outputPath = "StyledParagraphs.docx";
+        // Save the document to the current directory.
+        string outputPath = Path.Combine(Directory.GetCurrentDirectory(), "StyledParagraphs.docx");
         doc.Save(outputPath);
-
-        // Ensure the output file was created.
-        if (!File.Exists(outputPath))
-            throw new Exception("The document was not saved successfully.");
     }
 }

fonts/apply-a-semi-transparent-fill-to-text-by-setting-font-fill-color-and-font-fill-transparenc.cs

@@ -2,52 +2,49 @@
 using System.IO;
 using Aspose.Words;
 using Aspose.Words.Drawing;
-using Aspose.Drawing;
+using Aspose.Drawing; // For Aspose.Drawing.Color
 
 public class Program
 {
     public static void Main()
     {
         // Create a new blank document.
         Document doc = new Document();
-
-        // Use DocumentBuilder to add a paragraph with a run of text.
         DocumentBuilder builder = new DocumentBuilder(doc);
-        builder.Writeln("This text has a semi‑transparent fill.");
 
-        // Access the Font of the last run (the one just added).
+        // Insert a line of text.
+        builder.Writeln("Hello, semi‑transparent fill!");
+
+        // Access the font of the last inserted run.
         Aspose.Words.Font font = builder.Font;
 
-        // Ensure the fill is a solid fill.
-        font.Fill.Solid();
+        // Define a solid fill color (red) using Aspose.Drawing.Color.
+        Aspose.Drawing.Color fillColor = Aspose.Drawing.Color.Red;
 
-        // Create an Aspose.Drawing.Color and convert it to System.Drawing.Color for the Fill.
-        Aspose.Drawing.Color aspColor = Aspose.Drawing.Color.Blue;
-        System.Drawing.Color sysColor = System.Drawing.Color.FromArgb(aspColor.ToArgb());
+        // Apply the fill color to the font. The Solid method expects System.Drawing.Color,
+        // so convert the Aspose.Drawing.Color to System.Drawing.Color.
+        font.Fill.Solid(System.Drawing.Color.FromArgb(fillColor.ToArgb()));
 
-        // Set the fill color and transparency.
-        font.Fill.Color = sysColor;
+        // Set the fill transparency to 50% (0.5).
         font.Fill.Transparency = 0.5;
 
-        // Validate the applied properties.
-        if (Math.Abs(font.Fill.Transparency - 0.5) > 0.0001 ||
-            font.Fill.Color.ToArgb() != sysColor.ToArgb())
+        // Validate that the properties were set correctly.
+        if (font.Fill.Color.ToArgb() != fillColor.ToArgb() ||
+            Math.Abs(font.Fill.Transparency - 0.5) > 0.0001)
         {
-            throw new InvalidOperationException("Font fill properties were not set correctly.");
+            throw new InvalidOperationException("Fill properties were not applied as expected.");
         }
 
-        // Prepare output directory.
-        string outputDir = Path.Combine(Directory.GetCurrentDirectory(), "Output");
+        // Ensure the output directory exists.
+        string outputDir = "Output";
         Directory.CreateDirectory(outputDir);
+        string outputPath = Path.Combine(outputDir, "SemiTransparentFill.docx");
 
         // Save the document.
-        string outputPath = Path.Combine(outputDir, "SemiTransparentFill.docx");
         doc.Save(outputPath);
 
         // Verify that the file was created.
         if (!File.Exists(outputPath))
-        {
-            throw new FileNotFoundException("The document was not saved correctly.", outputPath);
-        }
+            throw new FileNotFoundException("The document was not saved.", outputPath);
     }
 }

fonts/apply-bold-and-italic-styles-to-a-run-by-setting-font-bold-and-font-italic-to-true.cs

@@ -1,8 +1,6 @@
 using System;
 using System.IO;
 using Aspose.Words;
-using Aspose.Drawing;
-using Newtonsoft.Json;
 
 public class Program
 {
@@ -11,31 +9,29 @@ public static void Main()
         // Create a new blank document.
         Document doc = new Document();
 
-        // Use DocumentBuilder to add content.
-        DocumentBuilder builder = new DocumentBuilder(doc);
+        // Create a Run containing the desired text.
+        Run run = new Run(doc, "Bold and Italic text");
 
-        // Apply bold and italic formatting to the current font.
-        Aspose.Words.Font font = builder.Font;
+        // Access the Run's font and set Bold and Italic to true.
+        Aspose.Words.Font font = run.Font;
         font.Bold = true;
         font.Italic = true;
 
-        // Insert a line of text that will inherit the formatting.
-        builder.Writeln("This text is bold and italic.");
-
-        // Validate that the formatting was applied.
+        // Validate that the properties were set correctly.
         if (!font.Bold || !font.Italic)
-        {
-            throw new InvalidOperationException("Failed to set font styles.");
-        }
+            throw new InvalidOperationException("Failed to apply bold or italic style to the run.");
+
+        // Append the Run to the first paragraph of the document.
+        doc.FirstSection.Body.FirstParagraph.AppendChild(run);
 
-        // Save the document to the current directory.
+        // Define the output file path.
         string outputPath = Path.Combine(Directory.GetCurrentDirectory(), "BoldItalicRun.docx");
+
+        // Save the document.
         doc.Save(outputPath);
 
         // Verify that the file was created.
         if (!File.Exists(outputPath))
-        {
-            throw new FileNotFoundException("The document was not saved.", outputPath);
-        }
+            throw new FileNotFoundException("The document was not saved correctly.", outputPath);
     }
 }