com.aspose.words

Class DocumentPartSavingArgs

  • java.lang.Object
    • com.aspose.words.DocumentPartSavingArgs
public class DocumentPartSavingArgs 
extends java.lang.Object

When Aspose.Words saves a document to HTML or related formats and HtmlSaveOptions.DocumentSplitCriteria is specified, the document is split into parts and by default, each document part is saved into a separate file.

Class DocumentPartSavingArgs allows you to control how each document part will be saved. It allows to redefine how file names are generated or to completely circumvent saving of document parts into files by providing your own stream objects.

To save document parts into streams instead of files, use the DocumentPartStream property.

Property Getters/Setters Summary
DocumentgetDocument()
Gets the document object that is being saved.
java.lang.StringgetDocumentPartFileName()
void
setDocumentPartFileName(java.lang.Stringvalue)
           Gets or sets the file name (without path) where the document part will be saved to.
java.io.OutputStreamgetDocumentPartStream()
void
setDocumentPartStream(java.io.OutputStreamvalue)
           Allows to specify the stream where the document part will be saved to.
booleangetKeepDocumentPartStreamOpen()
void
           Specifies whether Aspose.Words should keep the stream open or close it after saving a document part.
 

    • Property Getters/Setters Detail

      • getDocument

        public Document getDocument()
        
        Gets the document object that is being saved.
      • getDocumentPartFileName/setDocumentPartFileName

        public java.lang.String getDocumentPartFileName() / public void setDocumentPartFileName(java.lang.String value)
        
        Gets or sets the file name (without path) where the document part will be saved to.

        This property allows you to redefine how the document part file names are generated during export to HTML or EPUB.

        When the callback is invoked, this property contains the file name that was generated by Aspose.Words. You can change the value of this property to save the document part into a different file. Note that the file name for each part must be unique.

        DocumentPartFileName must contain only the file name without the path. Aspose.Words determines the path for saving using the document file name. If output document file name was not specified, for instance when saving to a stream, this file name is used only for referencing document parts. The same is true when saving to EPUB format.

        See Also:
        DocumentPartStream
      • getDocumentPartStream/setDocumentPartStream

        public java.io.OutputStream getDocumentPartStream() / public void setDocumentPartStream(java.io.OutputStream value)
        
        Allows to specify the stream where the document part will be saved to.

        This property allows you to save document parts to streams instead of files during HTML export.

        The default value is null. When this property is null, the document part will be saved to a file specified in the DocumentPartFileName property.

        When saving to a stream in HTML format is requested by Document.save(java.io.OutputStream,int) or Document.save(java.io.OutputStream,com.aspose.words.SaveOptions) and first document part is about to be saved, Aspose.Words suggests here the main output stream initially passed by the caller.

        When saving to EPUB format that is a container format based on HTML, DocumentPartStream cannot be specified because all subsidiary parts will be encapsulated into a single output package.

        See Also:
        KeepDocumentPartStreamOpen
      • getKeepDocumentPartStreamOpen/setKeepDocumentPartStreamOpen

        public boolean getKeepDocumentPartStreamOpen() / public void setKeepDocumentPartStreamOpen(boolean value)
        
        Specifies whether Aspose.Words should keep the stream open or close it after saving a document part.

        Default is false and Aspose.Words will close the stream you provided in the DocumentPartStream property after writing a document part into it. Specify true to keep the stream open. Please note that the main output stream provided in the call to Document.save(java.io.OutputStream,int) or Document.save(java.io.OutputStream,com.aspose.words.SaveOptions) will never be closed by Aspose.Words even if KeepDocumentPartStreamOpen is set to false.

        See Also:
        DocumentPartStream