Document
Inheritance: java.lang.Object, com.aspose.pdf.IVentureLicenseTarget, com.aspose.pdf.ADocument
All Implemented Interfaces: com.aspose.pdf.IDocument
public final class Document extends ADocument implements IDocument
Class representing PDF document
Constructors
Constructor | Description |
---|---|
Document() | Initializes empty document. |
Document(byte[] input) | Initialize new Document instance from the input byte array. |
Document(InputStream input) | Initialize new Document instance from the input stream. |
Document(InputStream input, String password) | Initialize new Document instance from the input stream. |
Document(System.IO.Stream input) | Initialize new Document instance from the input stream. |
Document(InputStream input, String password, boolean isManagedStream) | Initialize new Document instance from the input stream. |
Document(InputStream input, boolean isManagedStream) | Initialize new Document instance from the input stream. |
Document(InputStream input, LoadOptions options) | Opens an existing document from a stream providing necessary converting to get pdf document. |
Document(String filename, LoadOptions options) | Opens an existing document from a file providing necessary converting to get pdf document. |
Document(System.IO.Stream input, String password) | Opens an existing document from a stream. |
Document(String filename) | Just init Document using filename . |
Document(String filename, String password) | Initializes new instance of the Document class for working with encrypted document. |
Document(String filename, String password, boolean isManagedStream) | Initializes new instance of the Document class for working with encrypted document. |
Methods
Method | Description |
---|---|
getPageInfo() | Gets the page info. |
setPageInfo(PageInfo value) | Sets the page info. |
getDestinations() | Gets the collection of destinations. |
getPdfFormat() | Gets pdfa format |
getFontUtilities() | IDocumentFontUtilities instance |
removePdfaCompliance() | Remove pdfa compliance from the document |
getCollection() | Gets collection of document. |
setCollection(Collection value) | Sets collection of document. |
getEngineDoc() | Instance of IPdfDocument used to access to internal document structure. |
getVersion() | Gets a version of Pdf from Pdf file header. |
getOpenAction() | Gets action performed at document opening. |
setOpenAction(IAppointment value) | Sets action performed at document opening. |
isHideToolBar() | Gets flag specifying whether toolbar should be hidden when document is active. |
setHideToolBar(boolean value) | Set flag specifying whether toolbar should be hidden when document is active. |
isHideMenubar() | Gets flag specifying whether menu bar should be hidden when document is active. |
setHideMenubar(boolean value) | Sets flag specifying whether menu bar should be hidden when document is active. |
isHideWindowUI() | Gets flag specifying whether user interface elements should be hidden when document is active. |
setHideWindowUI(boolean value) | Sets flag specifying whether user interface elements should be hidden when document is active. |
isFitWindow() | Gets flag specifying whether document window must be resized to fit the first displayed page. |
setFitWindow(boolean value) | Sets flag specifying whether document window must be resized to fit the first displayed page. |
isCenterWindow() | Gets flag specifying whether position of the document’s window will be centered on the screen. |
setCenterWindow(boolean value) | Sets flag specifying whether position of the document’s window will be centered on the screen. |
isDisplayDocTitle() | Gets flag specifying whether document’s window title bar should display document title. |
setDisplayDocTitle(boolean value) | Sets flag specifying whether document’s window title bar should display document title. |
getPages() | Gets collection of document pages. |
getOutlines() | Gets document outlines. |
getActions() | Gets document actions. |
getForm() | Gets Acro Form of the document. |
getEmbeddedFiles() | Gets collection of files embedded to document. |
getDirection() | Gets reading order of text: L2R (left to right) or R2L (right to left). |
setDirection(int value) | Sets reading order of text: L2R (left to right) or R2L (right to left). |
getPageMode() | Gets page mode, specifying how document should be displayed when opened. |
setPageMode(int pageMode) | Sets page mode, specifying how document should be displayed when opened. |
getNonFullScreenPageMode() | Gets page mode, specifying how to display the document on exiting full-screen mode. |
setNonFullScreenPageMode(int value) | Sets page mode, specifying how to display the document on exiting full-screen mode. |
getPageLayout() | Gets page layout which shall be used when the document is opened. |
setPageLayout(int value) | Sets page layout which shall be used when the document is opened. |
getFileName() | Name of the PDF file that caused this document |
getInfo() | Gets document info. |
getMetadata() | Document metadata. |
getLogicalStructure() | Gets logical structure of the document. |
processParagraphs() | Stores document into stream. |
save(System.IO.Stream output) | Stores document into stream. |
save(OutputStream output) | Stores document into stream. |
save(String outputFileName) | Saves document into the specified file. |
exportAnnotationsToXfdf(String fileName) | Exports all document annotations to XFDF file |
sendTo(DocumentDevice device, OutputStream output) | Sends the whole document to the document device for processing. |
sendTo(DocumentDevice device, int fromPage, int toPage, OutputStream output) | Sends the certain pages of the document to the document device for processing. |
sendTo(DocumentDevice device, String outputFileName) | Sends the whole document to the document device for processing. |
sendTo(DocumentDevice device, int fromPage, int toPage, String outputFileName) | Sends the whole document to the document device for processing. |
removeMetadata() | Removes metadata from the document. |
importAnnotationsFromXfdf(String fileName) | Imports annotations from XFDF file to document. |
validate(String outputLogFileName, PdfFormat format) | Validate document into the specified file. |
convert(String outputLogFileName, PdfFormat format, int action) | Convert document and save errors into the specified file. |
validate(OutputStream outputLogStream, PdfFormat format) | Validate document into the specified file. |
convert(String outputLogFileName, PdfFormat format, int action, int transparencyAction) | Convert document and save errors into the specified file. |
convert(Document.CallBackGetHocr callback) | Recognize images inside the document and add hocr strings over it. |
convertWithSkippingErrors(Document.CallBackGetHocr callback) | Convert document to searchable document and skip errors of hochr that can not be converted. |
convertInternal(System.IO.Stream outputLogStream, PdfFormat format, int action) | Convert document and save errors into the specified stream. |
convert(OutputStream outputLogStream, PdfFormat format, int action) | Convert document and save errors into the specified stream. |
convert(PdfFormatConversionOptions options) | Convert document using specified conversion options |
convert(int fixup, OutputStream outputLog) | Convert document by applying the Fixup. |
convert(int fixup, OutputStream outputLog, boolean onlyValidation, Object[] parameters) | Convert document by applying the Fixup. |
convert(int fixup, String outputLog) | Convert document by applying the Fixup. |
convert(int fixup, String outputLog, boolean onlyValidation, Object[] parameters) | Convert document by applying the Fixup. |
flatten() | Removes all fields (and annotations) from the document and place their values instead. |
getCryptoAlgorithm() | Gets security settings if document is encrypted. |
encrypt(String userPassword, String ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20) | Encrypts the document. |
encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm) | Encrypts the document. |
encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20) | Encrypts the document. |
changePasswords(String ownerPassword, String newUserPassword, String newOwnerPassword) | Changes document passwords. |
isLinearized() | Gets a value indicating whether document is linearized. |
setLinearized(boolean value) | Sets a value indicating whether document is linearized. |
decrypt() | Decrypts the document. |
getPermissions() | Gets permissions of the document. |
isEncrypted() | Gets encrypted status of the document. |
optimize() | Linearize document in order to - open the first page as quickly as possible; - display next page or follow by link to the next page as quickly as possible; - display the page incrementally as it arrives when data for a page is delivered over a slow channel (display the most useful data first); - permit user interaction, such as following a link, to be performed even before the entire page has been received and displayed. |
save() | Save document incrementally (i.e. using incremental update technique). |
save(String outputFileName, SaveFormat format) | Saves the document with a new name along with a file format. |
saveIncrementally(OutputStream output) | Saves incrementally the PDF Document to the specified stream. |
saveIncrementally(System.IO.Stream output) | Saves incrementally the PDF Document to the specified stream. |
saveIncrementally(String outputFileName) | Saves incrementally the PDF Document to the specified stream. |
save(OutputStream outputStream, SaveFormat format) | Saves the document with a new name along with a file format. |
save(String outputFileName, SaveOptions options) | Saves the document with a new name setting its save options. |
save(OutputStream outputStream, SaveOptions options) | Saves the document to a stream with a save options. |
getId() | Gets the ID. |
getMetadataStream() | Returns raw metadata stream |
suppressUpdate() | Suppresses update contents data for all pages The contents is not updated until ResumeUpdate is called |
resumeUpdate() | resumes document update |
dispose() | Closes all resources used by this document. |
close() | Closes all resources used by this document. |
getBackground() | Gets the background color of the document. |
setBackground(Color value) | Sets the background color of the document. |
getDefaultCopier() | Returns copier used for coping pages to this document. |
optimizeResources() | Optimize resources in the document: 1. |
optimizeResources(OptimizationOptions strategy) | Optimize resources in the document according to defined optimization strategy. |
getOptimizeSize() | Gets optimization flag. |
setOptimizeSize(boolean value) | Sets optimization flag. |
getIgnoreCorruptedObjects() | Gets or sets flag of ignoring errors in source files. |
setIgnoreCorruptedObjects(boolean value) | Gets or sets flag of ignoring errors in source files. |
getCatalogValue(String key) | Returns item value from catalog dictionary. |
getPageLabels() | Gets page labels in the document. |
freeMemory() | Clears memory |
isAbsentFontTryToSubstitute() | Flag which informs about replacement of missing font. |
setAbsentFontTryToSubstitute(boolean setAbsentFontTryToSubstitute) | Setting flag for set program determined font in case of absense font. |
check(boolean doRepair) | Validates document. |
isManualDisposeEnabled() | By default method save close internal streams and release memory resources. |
setManualDisposeEnabled(boolean manualDisposeEnabled) | By default method save closes internal streams and release memory resources. |
pageNodesToBalancedTree() | Organizes page tree nodes in a document into a balanced tree. |
pageNodesToBalancedTree(byte nodesNumInSubtrees) | Organizes page tree nodes in a document into a balanced tree. |
Document()
public Document()
Initializes empty document.
Document(byte[] input)
public Document(byte[] input)
Initialize new Document instance from the input byte array.
Parameters:
Parameter | Type | Description |
---|---|---|
input | byte[] | byte array with pdf document. |
Document(InputStream input)
public Document(InputStream input)
Initialize new Document instance from the input stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | java.io.InputStream | Stream with pdf document. |
Document(InputStream input, String password)
public Document(InputStream input, String password)
Initialize new Document instance from the input stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | java.io.InputStream | Input stream object, corresponding pdf is password protected. |
password | java.lang.String | User or owner password. |
Document(System.IO.Stream input)
public Document(System.IO.Stream input)
Initialize new Document instance from the input stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | com.aspose.ms.System.IO.Stream | Stream with pdf document. |
Document(InputStream input, String password, boolean isManagedStream)
public Document(InputStream input, String password, boolean isManagedStream)
Initialize new Document instance from the input stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | java.io.InputStream | Stream with pdf document. |
password | java.lang.String | User or owner password. |
isManagedStream | boolean | if set to true inner stream is closed before exit; otherwise, is not. |
Document(InputStream input, boolean isManagedStream)
public Document(InputStream input, boolean isManagedStream)
Initialize new Document instance from the input stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | java.io.InputStream | Stream with pdf document. |
isManagedStream | boolean | if set to true inner stream is closed before exit; otherwise, is not. |
Document(InputStream input, LoadOptions options)
public Document(InputStream input, LoadOptions options)
Opens an existing document from a stream providing necessary converting to get pdf document.
Parameters:
Parameter | Type | Description |
---|---|---|
input | java.io.InputStream | Input stream to convert into pdf document. |
options | LoadOptions | Represents properties for converting input into pdf document. |
Document(String filename, LoadOptions options)
public Document(String filename, LoadOptions options)
Opens an existing document from a file providing necessary converting to get pdf document.
Parameters:
Parameter | Type | Description |
---|---|---|
filename | java.lang.String | Input file to convert into pdf document. |
options | LoadOptions | Represents properties for converting filename into pdf document. |
Document(System.IO.Stream input, String password)
public Document(System.IO.Stream input, String password)
Opens an existing document from a stream.
Parameters:
Parameter | Type | Description |
---|---|---|
input | com.aspose.ms.System.IO.Stream | Input file to convert into pdf document. |
password | java.lang.String | User or owner password. |
Document(String filename)
public Document(String filename)
Just init Document using filename . The same as Document(Stream) .
Parameters:
Parameter | Type | Description |
---|---|---|
filename | java.lang.String | The name of the pdf document file. |
Document(String filename, String password)
public Document(String filename, String password)
Initializes new instance of the Document class for working with encrypted document.
Parameters:
Parameter | Type | Description |
---|---|---|
filename | java.lang.String | Document file name. |
password | java.lang.String | User or owner password. |
Document(String filename, String password, boolean isManagedStream)
public Document(String filename, String password, boolean isManagedStream)
Initializes new instance of the Document class for working with encrypted document.
Parameters:
Parameter | Type | Description |
---|---|---|
filename | java.lang.String | Document file name. |
password | java.lang.String | User or owner password. |
isManagedStream | boolean | if set to true inner stream is closed before exit; otherwise, is not. |
getPageInfo()
public PageInfo getPageInfo()
Gets the page info.(for generator only, not filled in when reading document)
Returns: PageInfo - The page info.
setPageInfo(PageInfo value)
public void setPageInfo(PageInfo value)
Sets the page info.(for generator only, not filled in when reading document)
Parameters:
Parameter | Type | Description |
---|---|---|
value | PageInfo | PageInfo object |
getDestinations()
public DestinationCollection getDestinations()
Gets the collection of destinations.
Returns: DestinationCollection - DestinationCollection element
getPdfFormat()
public PdfFormat getPdfFormat()
Gets pdfa format
Returns: PdfFormat - PdfFormat element
getFontUtilities()
public Document.IDocumentFontUtilities getFontUtilities()
IDocumentFontUtilities instance
Returns: IDocumentFontUtilities - IDocumentFontUtilities instance
removePdfaCompliance()
public void removePdfaCompliance()
Remove pdfa compliance from the document
getCollection()
public Collection getCollection()
Gets collection of document.
Returns: Collection - Collection object
setCollection(Collection value)
public void setCollection(Collection value)
Sets collection of document.
Parameters:
Parameter | Type | Description |
---|---|---|
value | Collection | Collection object |
getEngineDoc()
public IPdfDocument getEngineDoc()
Instance of IPdfDocument used to access to internal document structure. Internal only
Returns: IPdfDocument - IPdfDocument object
getVersion()
public String getVersion()
Gets a version of Pdf from Pdf file header.
Returns: java.lang.String - String value
getOpenAction()
public IAppointment getOpenAction()
Gets action performed at document opening.
Example demonstrates how to get CenterWindow flag:
Document document = new Document("sample.pdf");
IAppointment value = document.getOpenAction();
Returns: IAppointment - IAppointment object
setOpenAction(IAppointment value)
public void setOpenAction(IAppointment value)
Sets action performed at document opening.
Parameters:
Parameter | Type | Description |
---|---|---|
value | IAppointment | IAppointment value |
isHideToolBar()
public boolean isHideToolBar()
Gets flag specifying whether toolbar should be hidden when document is active.
Returns: boolean - boolean value
Example demonstrates how to get HideToolBar flag:
Document document = new Document("sample.pdf");
boolean value = document.isHideToolBar();
setHideToolBar(boolean value)
public void setHideToolBar(boolean value)
Set flag specifying whether toolbar should be hidden when document is active.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
isHideMenubar()
public boolean isHideMenubar()
Gets flag specifying whether menu bar should be hidden when document is active.
Returns: boolean - boolean value
Example demonstrates how to get HideMenubar flag:
Document document = new Document("sample.pdf");
boolean value = document.isHideMenubar();
setHideMenubar(boolean value)
public void setHideMenubar(boolean value)
Sets flag specifying whether menu bar should be hidden when document is active.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
isHideWindowUI()
public boolean isHideWindowUI()
Gets flag specifying whether user interface elements should be hidden when document is active.
Returns: boolean - boolean value
Example demonstrates how to get HideWindowUI flag:
Document document = new Document("sample.pdf");
boolean value = document.isHideWindowUI();
setHideWindowUI(boolean value)
public void setHideWindowUI(boolean value)
Sets flag specifying whether user interface elements should be hidden when document is active.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
isFitWindow()
public boolean isFitWindow()
Gets flag specifying whether document window must be resized to fit the first displayed page.
Returns: boolean - boolean value
Example demonstrates how to get FitWindow flag:
Document document = new Document("sample.pdf");
boolean value = document.isFitWindow();
setFitWindow(boolean value)
public void setFitWindow(boolean value)
Sets flag specifying whether document window must be resized to fit the first displayed page.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
isCenterWindow()
public boolean isCenterWindow()
Gets flag specifying whether position of the document’s window will be centered on the screen.
Returns: boolean - boolean value
Example demonstrates how to get CenterWindow flag:
Document document = new Document("sample.pdf");
boolean value = document.isCenterWindow();
setCenterWindow(boolean value)
public void setCenterWindow(boolean value)
Sets flag specifying whether position of the document’s window will be centered on the screen.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
isDisplayDocTitle()
public boolean isDisplayDocTitle()
Gets flag specifying whether document’s window title bar should display document title.
Returns: boolean - boolean value
Example demonstrates how to get DisplayDocTitle flag:
Document document = new Document("sample.pdf");
boolean value = document.isDisplayDocTitle();
setDisplayDocTitle(boolean value)
public void setDisplayDocTitle(boolean value)
Sets flag specifying whether document’s window title bar should display document title.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
getPages()
public PageCollection getPages()
Gets collection of document pages. Note that pages are numbered from 1 in collection.
Returns: PageCollection - PageCollection object
Example below demonstrates how to operate with the document pages:
How to obtain number of pages and how to obtain rectangle of starting page of the document.
Document document = new Document("sample.pdf");
PageCollection pages = document.getPages();
System.out.println("Document contains " + pages.size());
Page page = pages.get_Item(1);
Rectangle rect = page.getRect();
getOutlines()
public OutlineCollection getOutlines()
Gets document outlines.
Returns: OutlineCollection - OutlineCollection object
getActions()
public DocumentActionCollection getActions()
Gets document actions. This property is instance of DocumentActions class which allows to get/set BeforClosing, BeforSaving, etc. actions.
Returns: DocumentActionCollection - DocumentActionCollection object
This example demonstrates how to obtain after open action of the document:
Document document = new Document("PdfWithOpenAction.pdf");
DocumentActionCollection actions = document.getActions();
PdfAction afterSavingAction = actions.getAfterSaving();
getForm()
public Form getForm()
Gets Acro Form of the document.
Returns: Form - Form object
getEmbeddedFiles()
public EmbeddedFileCollection getEmbeddedFiles()
Gets collection of files embedded to document.
Returns: EmbeddedFileCollection - EmbeddedFileCollection object
getDirection()
public int getDirection()
Gets reading order of text: L2R (left to right) or R2L (right to left).
Returns: int - Direction element
setDirection(int value)
public void setDirection(int value)
Sets reading order of text: L2R (left to right) or R2L (right to left).
Parameters:
Parameter | Type | Description |
---|---|---|
value | int | int value |
getPageMode()
public int getPageMode()
Gets page mode, specifying how document should be displayed when opened.
Returns: int - PageMode element
setPageMode(int pageMode)
public void setPageMode(int pageMode)
Sets page mode, specifying how document should be displayed when opened.
Parameters:
Parameter | Type | Description |
---|---|---|
pageMode | int | int value |
getNonFullScreenPageMode()
public int getNonFullScreenPageMode()
Gets page mode, specifying how to display the document on exiting full-screen mode.
Returns: int - PageMode element
setNonFullScreenPageMode(int value)
public void setNonFullScreenPageMode(int value)
Sets page mode, specifying how to display the document on exiting full-screen mode.
Parameters:
Parameter | Type | Description |
---|---|---|
value | int | int value |
getPageLayout()
public int getPageLayout()
Gets page layout which shall be used when the document is opened.
Returns: int - PageLayout element
setPageLayout(int value)
public void setPageLayout(int value)
Sets page layout which shall be used when the document is opened.
Parameters:
Parameter | Type | Description |
---|---|---|
value | int | int value |
getFileName()
public String getFileName()
Name of the PDF file that caused this document
Returns: java.lang.String - String object
getInfo()
public DocumentInfo getInfo()
Gets document info.
Returns: DocumentInfo - DocumentInfo object
getMetadata()
public Metadata getMetadata()
Document metadata. (A PDF document may include general information, such as the document’s title, author, and creation and modification dates. Such global information about the document (as opposed to its content or structure) is called metadata and is intended to assist in cataloguing and searching for documents in external databases.)
Returns: Metadata - Metadata object
getLogicalStructure()
public RootElement getLogicalStructure()
Gets logical structure of the document.
Returns: RootElement - RootElement object
processParagraphs()
public void processParagraphs()
Stores document into stream.
save(System.IO.Stream output)
public void save(System.IO.Stream output)
Stores document into stream.
Parameters:
Parameter | Type | Description |
---|---|---|
output | com.aspose.ms.System.IO.Stream | Stream where document shell be stored. |
save(OutputStream output)
public void save(OutputStream output)
Stores document into stream.
Parameters:
Parameter | Type | Description |
---|---|---|
output | java.io.OutputStream | Stream where document shell be stored. |
save(String outputFileName)
public void save(String outputFileName)
Saves document into the specified file.
Parameters:
Parameter | Type | Description |
---|---|---|
outputFileName | java.lang.String | Path to file where the document will be stored. |
exportAnnotationsToXfdf(String fileName)
public void exportAnnotationsToXfdf(String fileName)
Exports all document annotations to XFDF file
Parameters:
Parameter | Type | Description |
---|---|---|
fileName | java.lang.String | XFDF file name |
sendTo(DocumentDevice device, OutputStream output)
public void sendTo(DocumentDevice device, OutputStream output)
Sends the whole document to the document device for processing.
Parameters:
Parameter | Type | Description |
---|---|---|
device | DocumentDevice | Document device which is used to process the document. |
output | java.io.OutputStream | Output stream contains the results of the document processing with given device. |
sendTo(DocumentDevice device, int fromPage, int toPage, OutputStream output)
public void sendTo(DocumentDevice device, int fromPage, int toPage, OutputStream output)
Sends the certain pages of the document to the document device for processing.
Parameters:
Parameter | Type | Description |
---|---|---|
device | DocumentDevice | Document device which is used to process the document. |
fromPage | int | The first page for processing. |
toPage | int | The last page for processing. |
output | java.io.OutputStream | Output stream contains the results of the document pages processing with given device. |
sendTo(DocumentDevice device, String outputFileName)
public void sendTo(DocumentDevice device, String outputFileName)
Sends the whole document to the document device for processing.
Parameters:
Parameter | Type | Description |
---|---|---|
device | DocumentDevice | Document device which is used to process the document. |
outputFileName | java.lang.String | Output file name with the results of processing. |
sendTo(DocumentDevice device, int fromPage, int toPage, String outputFileName)
public void sendTo(DocumentDevice device, int fromPage, int toPage, String outputFileName)
Sends the whole document to the document device for processing.
Parameters:
Parameter | Type | Description |
---|---|---|
device | DocumentDevice | Document device which is used to process the document. |
fromPage | int | The first page for processing. |
toPage | int | The last page for processing. |
outputFileName | java.lang.String | Output file name with the results of processing. |
removeMetadata()
public void removeMetadata()
Removes metadata from the document.
importAnnotationsFromXfdf(String fileName)
public void importAnnotationsFromXfdf(String fileName)
Imports annotations from XFDF file to document.
Parameters:
Parameter | Type | Description |
---|---|---|
fileName | java.lang.String | XFDF file name |
validate(String outputLogFileName, PdfFormat format)
public boolean validate(String outputLogFileName, PdfFormat format)
Validate document into the specified file.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogFileName | java.lang.String | Path to file where the comments will be stored. |
format | PdfFormat | PdfFormat element. |
Returns: boolean
convert(String outputLogFileName, PdfFormat format, int action)
public boolean convert(String outputLogFileName, PdfFormat format, int action)
Convert document and save errors into the specified file.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogFileName | java.lang.String | Path to file where the comments will be stored. |
format | PdfFormat | Pdf format. |
action | int | Action for objects that can not be converted |
Returns: boolean - boolean value
validate(OutputStream outputLogStream, PdfFormat format)
public boolean validate(OutputStream outputLogStream, PdfFormat format)
Validate document into the specified file.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogStream | java.io.OutputStream | Stream where the comments will be stored. |
format | PdfFormat | Pdf format. |
Returns: boolean - boolean value
convert(String outputLogFileName, PdfFormat format, int action, int transparencyAction)
public boolean convert(String outputLogFileName, PdfFormat format, int action, int transparencyAction)
Convert document and save errors into the specified file.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogFileName | java.lang.String | Path to file where the comments will be stored. |
format | PdfFormat | The pdf format. |
action | int | Action for objects that can not be converted |
transparencyAction | int | Action for image masked objects |
Returns: boolean - The operation result
convert(Document.CallBackGetHocr callback)
public boolean convert(Document.CallBackGetHocr callback)
Recognize images inside the document and add hocr strings over it.
Parameters:
Parameter | Type | Description |
---|---|---|
callback | CallBackGetHocr | callback Action for images that will be processed by hocr recognize. |
Returns: boolean - boolean value The operation result. If there are no images in the document returns false .
convertWithSkippingErrors(Document.CallBackGetHocr callback)
public boolean convertWithSkippingErrors(Document.CallBackGetHocr callback)
Convert document to searchable document and skip errors of hochr that can not be converted.
Parameters:
Parameter | Type | Description |
---|---|---|
callback | CallBackGetHocr | The call back procedure for hocr recognize. |
Returns: boolean - boolean value
convertInternal(System.IO.Stream outputLogStream, PdfFormat format, int action)
public boolean convertInternal(System.IO.Stream outputLogStream, PdfFormat format, int action)
Convert document and save errors into the specified stream.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogStream | com.aspose.ms.System.IO.Stream | Stream where the comments will be stored. |
format | PdfFormat | Pdf format. |
action | int | The call back procedure for hocr recognize. |
Returns: boolean - boolean value
convert(OutputStream outputLogStream, PdfFormat format, int action)
public boolean convert(OutputStream outputLogStream, PdfFormat format, int action)
Convert document and save errors into the specified stream.
Parameters:
Parameter | Type | Description |
---|---|---|
outputLogStream | java.io.OutputStream | Stream where the comments will be stored. |
format | PdfFormat | Pdf format. |
action | int | Action for objects that can not be converted |
Returns: boolean - boolean value
convert(PdfFormatConversionOptions options)
public boolean convert(PdfFormatConversionOptions options)
Convert document using specified conversion options
Parameters:
Parameter | Type | Description |
---|---|---|
options | PdfFormatConversionOptions | set of options for convert PDF document |
Returns: boolean - The operation result
convert(int fixup, OutputStream outputLog)
public final boolean convert(int fixup, OutputStream outputLog)
Convert document by applying the Fixup.
Parameters:
Parameter | Type | Description |
---|---|---|
fixup | int | The Fixup type. |
outputLog | java.io.OutputStream | The log of process. |
Returns: boolean - The operation result.
convert(int fixup, OutputStream outputLog, boolean onlyValidation, Object[] parameters)
public final boolean convert(int fixup, OutputStream outputLog, boolean onlyValidation, Object[] parameters)
Convert document by applying the Fixup.
Parameters:
Parameter | Type | Description |
---|---|---|
fixup | int | The Fixup type. |
outputLog | java.io.OutputStream | The log of process. |
onlyValidation | boolean | Only document validation. |
parameters | java.lang.Object[] | Properties for Fixup that can not be set. |
Returns: boolean - The operation result.
convert(int fixup, String outputLog)
public boolean convert(int fixup, String outputLog)
Convert document by applying the Fixup.
Parameters:
Parameter | Type | Description |
---|---|---|
fixup | int | The Fixup type. |
outputLog | java.lang.String | The log of process. |
Returns: boolean - The operation result.
convert(int fixup, String outputLog, boolean onlyValidation, Object[] parameters)
public boolean convert(int fixup, String outputLog, boolean onlyValidation, Object[] parameters)
Convert document by applying the Fixup.
Parameters:
Parameter | Type | Description |
---|---|---|
fixup | int | The Fixup type. |
outputLog | java.lang.String | The log of process. |
onlyValidation | boolean | Only document validation. |
parameters | java.lang.Object[] | Properties for Fixup that can not be set. |
Returns: boolean - The operation result.
flatten()
public void flatten()
Removes all fields (and annotations) from the document and place their values instead.
getCryptoAlgorithm()
public CryptoAlgorithm getCryptoAlgorithm()
Gets security settings if document is encrypted. If document is not encrypted then corresponding exception will be raised in .net 1.1 or CryptoAlgorithm will be null for other .net versions.
Returns: CryptoAlgorithm - CryptoAlgorithm element
encrypt(String userPassword, String ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20)
public void encrypt(String userPassword, String ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20)
Encrypts the document. Call then Save to get encrypted version of the document.
Parameters:
Parameter | Type | Description |
---|---|---|
userPassword | java.lang.String | User password. |
ownerPassword | java.lang.String | Owner password. |
privileges | DocumentPrivilege | Document permissions, see Permissions for details. |
cryptoAlgorithm | CryptoAlgorithm | Cryptographic algorithm, see CryptoAlgorithm for details. |
usePdf20 | boolean | Support for revision 6 (Extension 8). |
encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm)
public void encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm)
Encrypts the document. Call then Save to get encrypted version of the document.
Parameters:
Parameter | Type | Description |
---|---|---|
userPassword | java.lang.String | User password. |
ownerPassword | java.lang.String | Owner password. |
permissions | int | Document permissions, see Permissions for details. |
cryptoAlgorithm | CryptoAlgorithm | Cryptographic algorithm, see CryptoAlgorithm for details. |
encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20)
public void encrypt(String userPassword, String ownerPassword, int permissions, CryptoAlgorithm cryptoAlgorithm, boolean usePdf20)
Encrypts the document. Call then Save to get encrypted version of the document.
Parameters:
Parameter | Type | Description |
---|---|---|
userPassword | java.lang.String | User password. |
ownerPassword | java.lang.String | Owner password. |
permissions | int | Document permissions, see Permissions for details. |
cryptoAlgorithm | CryptoAlgorithm | Cryptographic algorithm, see CryptoAlgorithm for details. |
usePdf20 | boolean | Support for revision 6 (Extension 8). |
changePasswords(String ownerPassword, String newUserPassword, String newOwnerPassword)
public void changePasswords(String ownerPassword, String newUserPassword, String newOwnerPassword)
Changes document passwords. This action can be done only using owner password.
Parameters:
Parameter | Type | Description |
---|---|---|
ownerPassword | java.lang.String | Owner password. |
newUserPassword | java.lang.String | New user password. |
newOwnerPassword | java.lang.String | New owner password. |
isLinearized()
public boolean isLinearized()
Gets a value indicating whether document is linearized.
Returns: boolean - boolean value
setLinearized(boolean value)
public void setLinearized(boolean value)
Sets a value indicating whether document is linearized.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
decrypt()
public void decrypt()
Decrypts the document. Call then Save to obtain decrypted version of the document.
getPermissions()
public int getPermissions()
Gets permissions of the document.
Returns: int - int value
isEncrypted()
public boolean isEncrypted()
Gets encrypted status of the document. True if document is encrypted.
Returns: boolean - boolean value
optimize()
public void optimize()
Linearize document in order to - open the first page as quickly as possible; - display next page or follow by link to the next page as quickly as possible; - display the page incrementally as it arrives when data for a page is delivered over a slow channel (display the most useful data first); - permit user interaction, such as following a link, to be performed even before the entire page has been received and displayed. Invoking this method doesn’t actually saves the document. On the contrary the document only is prepared to have optimized structure, call then Save to get optimized document.
save()
public void save()
Save document incrementally (i.e. using incremental update technique).
In order to save document incrementally we should open the document file for writing. Therefore Document must not be initialized with InputStream but with path to the file, like in the next code snippet: Document doc = new Document(“document.pdf”); // make some changes and save the document incrementally doc.save();
In case when document was initialized with InputStream, writing to InputStream is impossible, so we recommend to use separate methods “save” to save document or “saveIncrementally” to save document incrementally.
save(String outputFileName, SaveFormat format)
public void save(String outputFileName, SaveFormat format)
Saves the document with a new name along with a file format.
Parameters:
Parameter | Type | Description |
---|---|---|
outputFileName | java.lang.String | Path to file where the document will be stored. |
format | SaveFormat | Format options. |
saveIncrementally(OutputStream output)
public void saveIncrementally(OutputStream output)
Saves incrementally the PDF Document to the specified stream.
Parameters:
Parameter | Type | Description |
---|---|---|
output | java.io.OutputStream | OutputStream object |
saveIncrementally(System.IO.Stream output)
public void saveIncrementally(System.IO.Stream output)
Saves incrementally the PDF Document to the specified stream.
Parameters:
Parameter | Type | Description |
---|---|---|
output | com.aspose.ms.System.IO.Stream | OutputStream object |
saveIncrementally(String outputFileName)
public void saveIncrementally(String outputFileName)
Saves incrementally the PDF Document to the specified stream.
Parameters:
Parameter | Type | Description |
---|---|---|
outputFileName | java.lang.String | OutputStream object |
save(OutputStream outputStream, SaveFormat format)
public void save(OutputStream outputStream, SaveFormat format)
Saves the document with a new name along with a file format.
Parameters:
Parameter | Type | Description |
---|---|---|
outputStream | java.io.OutputStream | Stream where the document will be stored. |
format | SaveFormat | Format options. |
save(String outputFileName, SaveOptions options)
public void save(String outputFileName, SaveOptions options)
Saves the document with a new name setting its save options.
Parameters:
Parameter | Type | Description |
---|---|---|
outputFileName | java.lang.String | Path to file where the document will be stored. |
options | SaveOptions | Save options. |
save(OutputStream outputStream, SaveOptions options)
public void save(OutputStream outputStream, SaveOptions options)
Saves the document to a stream with a save options.
Parameters:
Parameter | Type | Description |
---|---|---|
outputStream | java.io.OutputStream | Stream where the document will be stored. |
options | SaveOptions | Save options. |
getId()
public Id getId()
Gets the ID.
Returns: Id - Id object
getMetadataStream()
public IPdfStreamAccessor getMetadataStream()
Returns raw metadata stream
Returns: IPdfStreamAccessor - IPdfStreamAccessor object
suppressUpdate()
public void suppressUpdate()
Suppresses update contents data for all pages The contents is not updated until ResumeUpdate is called
resumeUpdate()
public void resumeUpdate()
resumes document update
dispose()
public void dispose()
Closes all resources used by this document.
This method is obsolete, use close() instead.
close()
public void close()
Closes all resources used by this document.
getBackground()
public Color getBackground()
Gets the background color of the document.
Returns: Color - Color object
setBackground(Color value)
public void setBackground(Color value)
Sets the background color of the document.
Parameters:
Parameter | Type | Description |
---|---|---|
value | java.awt.Color | Color object |
getDefaultCopier()
public Copier getDefaultCopier()
Returns copier used for coping pages to this document.
Returns: Copier - Copier object
optimizeResources()
public void optimizeResources()
Optimize resources in the document: 1. Resources which are not used on the document pages are removed; 2. Equal resources are joined into one object; 3. Unused objects are deleted.
optimizeResources(OptimizationOptions strategy)
public void optimizeResources(OptimizationOptions strategy)
Optimize resources in the document according to defined optimization strategy.
Parameters:
Parameter | Type | Description |
---|---|---|
strategy | OptimizationOptions | Optimization strategy. |
getOptimizeSize()
public boolean getOptimizeSize()
Gets optimization flag. When pages are added to document, equal resource streams in resultant file are merged into one PDF object if this flag set. This allows to decrease resultant file size but may cause slower execution and larger memory requirements. Default value: false.
Returns: boolean - boolean value
setOptimizeSize(boolean value)
public void setOptimizeSize(boolean value)
Sets optimization flag. When pages are added to document, equal resource streams in resultant file are merged into one PDF object if this flag set. This allows to decrease resultant file size but may cause slower execution and larger memory requirements. Default value: false.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
getIgnoreCorruptedObjects()
public boolean getIgnoreCorruptedObjects()
Gets or sets flag of ignoring errors in source files. When pages from source document copied into destination document, copying process is stopped with exception if some objects in source files are corrupted when this flag is false. example: dest.Pages.Add(src.Pages); If this flag is set to true then corrupted objects will be replaced with empty values. By default: true.
Returns: boolean - boolean value
setIgnoreCorruptedObjects(boolean value)
public void setIgnoreCorruptedObjects(boolean value)
Gets or sets flag of ignoring errors in source files. When pages from source document copied into destination document, copying process is stopped with exception if some objects in source files are corrupted when this flag is false. example: dest.Pages.Add(src.Pages); If this flag is set to true then corrupted objects will be replaced with empty values. By default: true.
Parameters:
Parameter | Type | Description |
---|---|---|
value | boolean | boolean value |
getCatalogValue(String key)
public Object getCatalogValue(String key)
Returns item value from catalog dictionary.
Parameters:
Parameter | Type | Description |
---|---|---|
key | java.lang.String | The key of item. |
Returns: java.lang.Object - Item value - if key was successfully found; otherwise, null.
getPageLabels()
public PageLabelCollection getPageLabels()
Gets page labels in the document.
Returns: PageLabelCollection - PageLabelCollection object
freeMemory()
public void freeMemory()
Clears memory
isAbsentFontTryToSubstitute()
public boolean isAbsentFontTryToSubstitute()
Flag which informs about replacement of missing font.
Returns: boolean
setAbsentFontTryToSubstitute(boolean setAbsentFontTryToSubstitute)
public void setAbsentFontTryToSubstitute(boolean setAbsentFontTryToSubstitute)
Setting flag for set program determined font in case of absense font.
Parameters:
Parameter | Type | Description |
---|---|---|
setAbsentFontTryToSubstitute | boolean |
check(boolean doRepair)
public boolean check(boolean doRepair)
Validates document.
Parameters:
Parameter | Type | Description |
---|---|---|
doRepair | boolean | If true found issues will be repaired. |
Returns: boolean - boolean value
isManualDisposeEnabled()
public boolean isManualDisposeEnabled()
By default method save close internal streams and release memory resources. We can do some operations and continue work with the document after method save if this ManualDispose parameter is enabled.
Returns: boolean - boolean value. (Default value == false)
setManualDisposeEnabled(boolean manualDisposeEnabled)
public void setManualDisposeEnabled(boolean manualDisposeEnabled)
By default method save closes internal streams and release memory resources. We can do some operations and continue work with the document after method save is called if this ManualDispose parameter is enabled. But it is strongly recommended to call the dispose method when the Document instance is no longer needed.
Parameters:
Parameter | Type | Description |
---|---|---|
manualDisposeEnabled | boolean | boolean value. (Default value == false) |
pageNodesToBalancedTree()
public final void pageNodesToBalancedTree()
Organizes page tree nodes in a document into a balanced tree. Only if the document has more than nodesNumInSubtrees page objects, otherwise it does nothing.
pageNodesToBalancedTree(byte nodesNumInSubtrees)
public final void pageNodesToBalancedTree(byte nodesNumInSubtrees)
Organizes page tree nodes in a document into a balanced tree. Only if the document has more than nodesNumInSubtrees page objects, otherwise it does nothing.
Parameters:
Parameter | Type | Description |
---|---|---|
nodesNumInSubtrees | byte | Desired number of subnodes. |