Merge branch 'main' into production

Author: sdfleod

english/java/com.aspose.words/_index.md

@@ -377,6 +377,7 @@ The **MailMerge** object which provides access to the reporting functionality is
 | [GlossaryDocument](../com.aspose.words/glossarydocument/) | Represents the root element for a glossary document within a Word document. |
 | [GlowFormat](../com.aspose.words/glowformat/) | Represents the glow formatting for an object. |
 | [Glyph](../com.aspose.words/glyph/) | Represents a glyph |
+| [GlyphFlags](../com.aspose.words/glyphflags/) |  |
 | [GoogleAiModel](../com.aspose.words/googleaimodel/) | An abstract class representing the integration with Google\\u2019s AI models within the Aspose.Words. |
 | [GradientStop](../com.aspose.words/gradientstop/) | Represents one gradient stop. |
 | [GradientStopCollection](../com.aspose.words/gradientstopcollection/) | Contains a collection of [GradientStop](../com.aspose.words/gradientstop/) objects. |
@@ -527,6 +528,7 @@ The **MailMerge** object which provides access to the reporting functionality is
 | [OutlineOptions](../com.aspose.words/outlineoptions/) | Allows to specify outline options. |
 | [PageBorderAppliesTo](../com.aspose.words/pageborderappliesto/) | Specifies which pages the page border is printed on. |
 | [PageBorderDistanceFrom](../com.aspose.words/pageborderdistancefrom/) | Specifies the positioning of the page border relative to the page margin. |
+| [PageExtractOptions](../com.aspose.words/pageextractoptions/) | Allows to specify options for document page extracting. |
 | [PageInfo](../com.aspose.words/pageinfo/) | Represents information about a particular document page. |
 | [PageLayoutCallbackArgs](../com.aspose.words/pagelayoutcallbackargs/) | An argument passed into [IPageLayoutCallback.\#notify(com.aspose.words.PageLayoutCallbackArgs)](../com.aspose.words/ipagelayoutcallback/\#notify-com.aspose.words.PageLayoutCallbackArgs) |
 | [PageLayoutEvent](../com.aspose.words/pagelayoutevent/) | A code of event raised during page layout model build and rendering. |
@@ -711,6 +713,7 @@ The **MailMerge** object which provides access to the reporting functionality is
 | [TxtTrailingSpacesOptions](../com.aspose.words/txttrailingspacesoptions/) | Specifies available options for trailing spaces handling during import from [LoadFormat.\#TEXT](../com.aspose.words/loadformat/\#TEXT) file. |
 | [Underline](../com.aspose.words/underline/) | Indicates type of the underline applied to a font. |
 | [UnicodeScript](../com.aspose.words/unicodescript/) | Unicode Character Database property: Script (sc). |
+| [UnsupportedEncryptionException](../com.aspose.words/unsupportedencryptionexception/) | Thrown during document load, when the document is encrypted with an unsupported method. |
 | [UnsupportedFileFormatException](../com.aspose.words/unsupportedfileformatexception/) | Thrown during document load, when the document format is not recognized or not supported by Aspose.Words. |
 | [UserInformation](../com.aspose.words/userinformation/) | Specifies information about the user. |
 | [VariableCollection](../com.aspose.words/variablecollection/) | A collection of document variables. |

english/java/com.aspose.words/absolutepositiontab/_index.md

@@ -1126,7 +1126,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/asposewordsprintdocument/_index.md

@@ -29,6 +29,57 @@ A single Aspose.Words document can consist of multiple sections that specify pag
 
 On the other hand, if the document consists of a single section only, the developer can use [AsposeWordsPrintDocument](../../com.aspose.words/asposewordsprintdocument/) as **java.awt.print.Printable** to improve printing performance.
 
+ **Examples:** 
+
+Shows how to monitor printing progress.
+
+```
+
+ Document doc = new Document(getMyDir() + "Rendering.docx");
+
+ // Create a special Aspose.Words implementation of the Java PrintDocument class
+ AsposeWordsPrintDocument printDoc = new AsposeWordsPrintDocument(doc);
+
+ // In Java, printer settings are handled through PrinterJob.
+ PrinterJob printerJob = PrinterJob.getPrinterJob();
+ printerJob.setPrintable(printDoc);
+
+ // Initialize the custom printing tracker.
+ PrintTracker printTracker = new PrintTracker(printDoc);
+
+ printerJob.print();
+
+ // Write the event log.
+ for (String eventString : printTracker.getEventLog()) {
+     System.out.println(eventString);
+ }
+ 
+```
+
+Shows an example class for monitoring the progress of printing.
+
+```
+{@code
+ /// 
+ /// Tracks printing progress of an Aspose.Words document and logs printing events.
+ /// 
+ /**
+ Tracks printing progress of an Aspose.Words document and logs printing events.
+ Note: Java version doesn't have the same event system as .NET, so this implementation
+ wraps the AsposeWordsPrintDocument to provide similar functionality.
+ /
+ class PrintTracker implements Printable {
+     private final AsposeWordsPrintDocument printDocument;
+     private int printingPage = -1;
+     private int totalPages = 0;
+     private final List eventLog = new ArrayList<>();
+     private boolean isPrinting = false;
+
+     /**
+ Initializes a new instance of the PrintTracker class
+ and wraps the specified Aspose.Words print document.
+```
+
 
 [Printing a Document Programmatically or Using Dialogs]: https://docs.aspose.com/words/java/print-a-document-programmatically-or-using-dialogs/
 ## Constructors
@@ -44,6 +95,7 @@ On the other hand, if the document consists of a single section only, the develo
 | [getColorPagesPrinted()](#getColorPagesPrinted) | Gets the number of pages printed in color (i.e. |
 | [getNumberOfPages()](#getNumberOfPages) |  |
 | [getPageFormat(int pageIndex)](#getPageFormat-int) |  |
+| [getPagesRemaining()](#getPagesRemaining) | Gets the number of pages remaining in the currently active print job. |
 | [getPrintable(int pageIndex)](#getPrintable-int) |  |
 | [print(Graphics graphics, PageFormat pageFormat, int pageIndex)](#print-java.awt.Graphics-java.awt.print.PageFormat-int) |  |
 | [setColorMode(int value)](#setColorMode-int) | Sets how non-colored pages are printed if the device supports color printing. |
@@ -109,6 +161,71 @@ public PageFormat getPageFormat(int pageIndex)
 
 **Returns:**
 java.awt.print.PageFormat
+### getPagesRemaining() {#getPagesRemaining}
+```
+public int getPagesRemaining()
+```
+
+
+Gets the number of pages remaining in the currently active print job.
+
+ **Remarks:** 
+
+This value is updated automatically as pages are printed, reflecting the current print job's progress. Outside of print time and in case of print job errors or interruptions, the value may not reflect the actual number of pages pending.
+
+ **Examples:** 
+
+Shows how to monitor printing progress.
+
+```
+
+ Document doc = new Document(getMyDir() + "Rendering.docx");
+
+ // Create a special Aspose.Words implementation of the Java PrintDocument class
+ AsposeWordsPrintDocument printDoc = new AsposeWordsPrintDocument(doc);
+
+ // In Java, printer settings are handled through PrinterJob.
+ PrinterJob printerJob = PrinterJob.getPrinterJob();
+ printerJob.setPrintable(printDoc);
+
+ // Initialize the custom printing tracker.
+ PrintTracker printTracker = new PrintTracker(printDoc);
+
+ printerJob.print();
+
+ // Write the event log.
+ for (String eventString : printTracker.getEventLog()) {
+     System.out.println(eventString);
+ }
+ 
+```
+
+Shows an example class for monitoring the progress of printing.
+
+```
+{@code
+ /// 
+ /// Tracks printing progress of an Aspose.Words document and logs printing events.
+ /// 
+ /**
+ Tracks printing progress of an Aspose.Words document and logs printing events.
+ Note: Java version doesn't have the same event system as .NET, so this implementation
+ wraps the AsposeWordsPrintDocument to provide similar functionality.
+ /
+ class PrintTracker implements Printable {
+     private final AsposeWordsPrintDocument printDocument;
+     private int printingPage = -1;
+     private int totalPages = 0;
+     private final List eventLog = new ArrayList<>();
+     private boolean isPrinting = false;
+
+     /**
+ Initializes a new instance of the PrintTracker class
+ and wraps the specified Aspose.Words print document.
+```
+
+**Returns:**
+int - The current page number being printed. / public int getPrintingPage() \{ return printingPage; \} /\*\* Gets the total number of pages to print. Returns 0 when no printing is in progress.
 ### getPrintable(int pageIndex) {#getPrintable-int}
 ```
 public Printable getPrintable(int pageIndex)

english/java/com.aspose.words/bookmarkend/_index.md

@@ -1033,7 +1033,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/bookmarkstart/_index.md

@@ -1125,7 +1125,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/commentrangeend/_index.md

@@ -1337,7 +1337,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/commentrangestart/_index.md

@@ -1337,7 +1337,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/document/_index.md

@@ -120,6 +120,7 @@ Shows how to execute a mail merge with data from a DataTable.
 | [ensureMinimum()](#ensureMinimum) | If the document contains no sections, creates one section with one paragraph. |
 | [expandTableStylesToDirectFormatting()](#expandTableStylesToDirectFormatting) | Converts formatting specified in table styles into direct formatting on tables in the document. |
 | [extractPages(int index, int count)](#extractPages-int-int) | Returns the [Document](../../com.aspose.words/document/) object representing specified range of pages. |
+| [extractPages(int index, int count, PageExtractOptions options)](#extractPages-int-int-com.aspose.words.PageExtractOptions) | Returns the [Document](../../com.aspose.words/document/) object representing the specified range of pages and the given page extract options. |
 | [fetchInheritedSectionAttr(int key)](#fetchInheritedSectionAttr-int) |  |
 | [fetchSectionAttr(int key)](#fetchSectionAttr-int) |  |
 | [fetchSectionAttr(int key, int revisionsView)](#fetchSectionAttr-int-int) |  |
@@ -1748,13 +1749,60 @@ Shows how to get specified range of pages from the document.
 
  doc.save(getArtifactsDir() + "Document.ExtractPages.docx");
  
+```
+
+Show how to reset the initial page numbering and save the NUMPAGE field.
+
+```
+
+ Document doc = new Document(getMyDir() + "Page fields.docx");
+
+ // Default behavior:
+ // The extracted page numbering is the same as in the original document, as if we had selected "Print 2 pages" in MS Word.
+ // The start page will be set to 2 and the field indicating the number of pages will be removed
+ // and replaced with a constant value equal to the number of pages.
+ Document extractedDoc1 = doc.extractPages(1, 1);
+ extractedDoc1.save(getArtifactsDir() + "Document.ExtractPagesWithOptions.Default.docx");
+
+ // Altered behavior:
+ // The extracted page numbering is reset and a new one begins,
+ // as if we had copied the contents of the second page and pasted it into a new document.
+ // The start page will be set to 1 and the field indicating the number of pages will be left unchanged
+ // and will show the current number of pages.
+ PageExtractOptions extractOptions = new PageExtractOptions();
+ extractOptions.setUpdatePageStartingNumber(false);
+ extractOptions.setUnlinkPagesNumberFields(false);
+ Document extractedDoc2 = doc.extractPages(1, 1, extractOptions);
+ extractedDoc2.save(getArtifactsDir() + "Document.ExtractPagesWithOptions.Options.docx");
+ 
+```
+
+**Parameters:**
+| Parameter | Type | Description |
+| --- | --- | --- |
+| index | int | The zero-based index of the first page to extract. |
+| count | int | Number of pages to be extracted. |
+
+**Returns:**
+[Document](../../com.aspose.words/document/)
+### extractPages(int index, int count, PageExtractOptions options) {#extractPages-int-int-com.aspose.words.PageExtractOptions}
 ```
+public Document extractPages(int index, int count, PageExtractOptions options)
+```
+
+
+Returns the [Document](../../com.aspose.words/document/) object representing the specified range of pages and the given page extract options.
+
+ **Remarks:** 
+
+The resulting document should look like the one in MS Word, as if we had performed 'Print specific pages' \\u2013 the numbering, headers/footers and cross tables layout will be preserved. But due to a large number of nuances, appearing while reducing the number of pages, full match of the layout is a quiet complicated task requiring a lot of effort. Depending on the document complexity there might be slight differences in the resulting document contents layout comparing to the source document. Any feedback would be greatly appreciated.
 
 **Parameters:**
 | Parameter | Type | Description |
 | --- | --- | --- |
 | index | int | The zero-based index of the first page to extract. |
 | count | int | Number of pages to be extracted. |
+| options | [PageExtractOptions](../../com.aspose.words/pageextractoptions/) | Provides options for managing the page extracting process. |
 
 **Returns:**
 [Document](../../com.aspose.words/document/)

english/java/com.aspose.words/editablerangeend/_index.md

@@ -1036,7 +1036,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:** 
 

english/java/com.aspose.words/editablerangestart/_index.md

@@ -1036,7 +1036,7 @@ public boolean isComposite()
 ```
 
 
-Returns  true  if this node can contain other nodes. (194242,6)
+Returns  true  if this node can contain other nodes. (194825,6)
 
  **Examples:**