Aspose.Words for Java 22.11 Release Notes

/// <summary>
/// Gets or sets a value determining whether or not to embed attachments to the PDF document.
/// </summary>
/// <remarks>
/// <para>Default value is <c>false</c> and attachments are not embedded.</para>
/// <para>When the value is <c>true</c> attachments are embedded to the PDF document.</para>
/// <para>Embedding attachments is not supported when saving to PDF/A and PDF/UA compliance.
/// <c>false</c> value will be used automatically.</para>
/// <para>Embedding attachments is not supported when encryption is enabled. <c>false</c> value
/// will be used automatically.</para>
/// </remarks>
public bool EmbedAttachments { get; set; }

Document doc = new Document();

// Create a structured document tag of the Citation type.
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.Citation, MarkupLevel.Inline);

// Append to a paragraph.
Paragraph paragraph = doc.FirstSection.Body.FirstParagraph;
paragraph.AppendChild(sdt);

// Create a Citation field.
DocumentBuilder builder = new DocumentBuilder(doc);
builder.MoveToParagraph(0, -1);
builder.InsertField(@"CITATION Ath22 \l 1033 ", "(Author1, 2022)");

// Move the field to the structured document tag.
while (sdt.NextSibling != null)
    sdt.AppendChild(sdt.NextSibling);

doc.Save("output.docx");

public static void Main(string[] args)
{
    string content = new string('\u0000', 20);

    File.WriteAllText("a.doc", content);
    OpenDoc("a.doc");

    File.WriteAllText("b.docx", content);
    OpenDoc("b.docx");
}

private static void OpenDoc(string fileName)
{
    try
    {
        Document doc = new Document(fileName);
    }
    catch (UnsupportedFileFormatException e)
    {
        Console.WriteLine("{0} is opened with exception", fileName);
        return;
    }

    Console.WriteLine("{0} is opened successfully", fileName);
}

// The code produces the following output:
// a.doc is opened successfully
// b.docx is opened with exception

/// <summary>
/// Gets or sets how non-colored pages are printed if the device supports color printing.
/// </summary>
/// <remarks>
/// Doesn't affect booklet printing.
/// </remarks>
public ColorPrintMode ColorMode { get; set; }

/// <summary>
/// Specifies how non-colored pages are printed if the device supports color printing.
/// </summary>
public enum ColorPrintMode
{
    /// <summary>
    /// All pages are printed according to the printer's capabilities and settings.
    /// </summary>
    Normal,

    /// <summary>
    /// Non-colored pages if detected are printed in grayscale.
    /// </summary>
    /// <remarks>
    /// <see cref="PageSettings.Color"/> is automatically set false for detected non-colored pages.
    /// If the printer does not support color printing, this setting is ignored.
    /// </remarks>
    GrayscaleAuto
}

/// <summary>
/// Gets the number of pages printed in color (i.e. with <see cref="PageSettings.Color"/> set to true).
/// </summary>
public int ColorPagesPrinted { get; }

Document document = new Document(filename);

// Select the required printer.
PrinterSettings printerSettings = new PrinterSettings();
printerSettings.PrinterName = "Microsoft Print to PDF";

// Specify the pages to print.
printerSettings.FromPage = 1;
printerSettings.ToPage = doc.PageCount;

AsposeWordsPrintDocument printDoc = new AsposeWordsPrintDocument(doc);
printDoc.PrinterSettings = printerSettings;

// Specify the new color print mode.
printDoc.ColorMode = ColorPrintMode.GrayscaleAuto;

printDoc.Print();

// Return the numer of pages printed in color.
return printDoc.ColorPagesPrinted;

/// <summary>
/// Gets or sets <see cref="IFieldUpdatingProgressCallback"/> implementation.
/// </summary>
public IFieldUpdatingProgressCallback FieldUpdatingProgressCallback { get; set; }

/// <summary>
/// Implement this interface if you want to track field updating progress.
/// </summary>
public interface IFieldUpdatingProgressCallback
{
    /// <summary>
    /// A user defined method that is called when updating progress is changed.
    /// </summary>
    void Notify(FieldUpdatingProgressArgs args);
}

/// <summary>
/// Provides data for the field updating progress event.
/// </summary>
public sealed class FieldUpdatingProgressArgs
{
    /// <summary>
    /// Gets the total fields count to be updated.
    /// </summary>
    /// <remarks>
    /// The value is not constant and may be increased during updating process.
    /// </remarks>
    public int TotalFieldsCount { get; }

    /// <summary>
    /// Gets the number of updated fields.
    /// </summary>
    public int UpdatedFieldsCount { get; }

    /// <summary>
    /// Gets a value indicating whether field updating is completed.
    /// </summary>
    public bool UpdateCompleted { get; }
}

Document document = new Document(filename);
document.FieldOptions.FieldUpdatingProgressCallback = new FieldUpdatingProgressCallback();;
document.UpdateFields();

public class FieldUpdatingProgressCallback : IFieldUpdatingProgressCallback
{
    void IFieldUpdatingProgressCallback.Notify(FieldUpdatingProgressArgs args)
    {
        Console.WriteLine($"{args.UpdateCompleted}/{args.TotalFieldsCount}");
    }
}

/// <summary>
/// Gets or sets a value determining whether or not to cache graphics placed in document's background.
/// </summary>
/// <remarks>
/// <para> Default value is <c>true</c> and background graphics are written to the PDF document as an xObject.</para>
/// <para> When the value is <c>false</c> background graphics are not cached.</para>
/// <para> Some shapes are not supported for caching(shapes with fields, bookmarks, HRefs).</para>
/// <para> Document background graphic is various shapes, charts, images placed in the footer or header,
/// well as background and border of a page.</para>
/// </remarks>
public bool CacheBackgroundGraphics { get; set; }

Document doc = new Document(fileName);
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.CacheBackgroundGraphics = true;
doc.Save(outputFileName, saveOptions);

<<tag_name ... #header1>><<tag_name ... #header2>>...<</tag_name #header2>><</tag_name #header1>>

<<doc [document_expression] -inline>>