Aspose.Words for .NET 23.3 Release Notes

/// <summary>
/// Gets or sets a ThemeColor object that represents the foreground color for the fill.
/// </summary>
public ThemeColor ForeThemeColor { get; set; }

/// <summary>
/// Gets or sets a ThemeColor object that represents the background color for the fill.
/// </summary>
public ThemeColor BackThemeColor { get; set; }

/// <summary>
/// Gets or sets a double value that lightens or darkens the foreground color.
/// </summary>
/// <remarks>
/// <para> The allowed values are within the range from -1 (the darkest) to 1 (the lightest) for this property.
/// Zero (0) is neutral. Attempting to set this property to a value less than -1 or more than 1
/// results in <see cref="ArgumentOutOfRangeException"/>.</para>
/// </remarks>
public double ForeTintAndShade { get; set; }

/// <summary>
/// Gets or sets a double value that lightens or darkens the background color.
/// </summary>
/// <remarks>
/// <para> The allowed values are within the range from -1 (the darkest) to 1 (the lightest) for this property.
/// Zero (0) is neutral. Attempting to set this property to a value less than -1 or more than 1
/// results in <see cref="ArgumentOutOfRangeException"/>.</para>
/// </remarks>
public double BackTintAndShade { get; set; }

Document doc = new Document("in.docx");

Fill shapeFill = (doc.GetChild(NodeType.Shape, 0, true) as Shape).Fill;
// Gets and sets the value of theme colors.
if (shapeFill.ForeThemeColor == ThemeColor.Accent1)
    shapeFill.ForeThemeColor = ThemeColor.Dark1;

if (shapeFill.BackThemeColor == ThemeColor.Accent2)
    shapeFill.BackThemeColor = ThemeColor.Dark2;

Fill textFill1 = doc.FirstSection.Body.FirstParagraph.Runs[0].Font.Fill;
// Gets and sets the tint value.
if (textFill1.ForeTintAndShade == 0)
    textFill1.ForeTintAndShade = 0.5;

Fill textFill2 = doc.FirstSection.Body.FirstParagraph.Runs[1].Font.Fill;
// Gets and sets the shade value.
if (textFill2.ForeTintAndShade == 0)
    textFill2.ForeTintAndShade = -0.2;

doc.Save("out.docx");

/// <summary>
/// Gets or sets a flag indicating whether the axis has major gridlines.
/// </summary>
public bool HasMajorGridlines { get; set; }

/// <summary>
/// Gets or sets a flag indicating whether the axis has minor gridlines.
/// </summary>
public bool HasMinorGridlines { get; set; }

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a chart.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

ChartAxis xAxis = shape.Chart.AxisX;
ChartAxis yAxis = shape.Chart.AxisY;

// Show gridlines.
xAxis.HasMajorGridlines = true;
xAxis.HasMinorGridlines = true;
yAxis.HasMajorGridlines = true;
yAxis.HasMinorGridlines = true;

doc.Save("Gridlines.docx");

/// <summary>
/// Gets or sets a boolean value that specifies whether to adjust sentence and word spacing automatically.
/// The default value is <c>false</c>.
/// </summary>
public bool AdjustSentenceAndWordSpacing { get; set; }

Document srcDoc = new Document();
Document dstDoc = new Document();

DocumentBuilder builder = new DocumentBuilder(srcDoc);
builder.Write("Dolor sit amet.");

builder = new DocumentBuilder(dstDoc);
builder.Write("Lorem ipsum.");

ImportFormatOptions options = new ImportFormatOptions() { AdjustSentenceAndWordSpacing = true };
builder.InsertDocument(srcDoc, ImportFormatMode.UseDestinationStyles, options);

Console.WriteLine(dstDoc.FirstSection.Body.FirstParagraph.GetText());

/* This code produces the following output (please note the additional ' ' space character just before pasted content):
Lorem ipsum. Dolor sit amet.
*/

/// <summary>
/// Gets or sets a boolean value indicating either text of the TextBox should not rotate when the shape is rotated.
/// </summary>
/// <remarks>
/// <p>The default value is <c>false</c></p>
/// </remarks>
public bool NoTextRotation

DocumentBuilder builder = new DocumentBuilder();
Shape shape = builder.InsertShape(ShapeType.Ellipse, 20, 20);
shape.TextBox.NoTextRotation = true;