Package com.itextpdf.kernel.pdf
Class PdfCatalog
The root of a document’s object hierarchy.
-
Field Summary
Modifier and TypeFieldDescriptionprotected Map<PdfName,
PdfNameTree> Map of thePdfNameTree
.protected PdfOCProperties
The document’s optional content properties dictionary.protected PdfNumTree
Defining the page labelling for the document. -
Constructor Summary
ModifierConstructorDescriptionprotected
PdfCatalog
(PdfDictionary pdfObject) CreatePdfCatalog
dictionary.protected
PdfCatalog
(PdfDocument pdfDocument) CreatePdfCatalog
toPdfDocument
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addDeveloperExtension
(PdfDeveloperExtension extension) Add an extensions dictionary containing developer prefix identification and version numbers for developer extensions that occur in this document.void
flush()
PdfCatalog will be flushed in PdfDocument.close().Gets collection dictionary that a conforming reader shall use to enhance the presentation of file attachments stored in the PDF document.GetPdfDocument
with indirect reference associated with the object.getLang()
Get natural language.getNameTree
(PdfName treeType) This method gets Names tree from the catalog.getOCProperties
(boolean createIfNotExists) Use this method to get the Optional Content Properties Dictionary.getPageLabelsTree
(boolean createIfNotExists) This method returns the NumberTree of Page LabelsGet page layout of the document.Get page mode of the document.Get viewer preferences of the document.protected boolean
True indicates that getOCProperties() was called, may have been modified, and thus its dictionary needs to be reconstructed.protected boolean
Defines if the object behind this wrapper must be an indirect object in the resultant document.Add key and value toPdfCatalog
dictionary.Remove key from catalog dictionary.setAdditionalAction
(PdfName key, PdfAction action) The actions that shall be taken in response to various trigger events affecting the document as a whole.setCollection
(PdfCollection collection) Sets collection dictionary that a conforming reader shall use to enhance the presentation of file attachments stored in the PDF document.void
An entry specifying the natural language, and optionally locale.setOpenAction
(PdfAction action) A value specifying an action that shall be performed when the document is opened.setOpenAction
(PdfDestination destination) A value specifying a destination that shall be displayed when the document is opened.setPageLayout
(PdfName pageLayout) This method sets a page layout of the documentsetPageMode
(PdfName pageMode) This method sets a page mode of the document.setViewerPreferences
(PdfViewerPreferences preferences) This method sets the document viewer preferences, specifying the way the document shall be displayed on the screenMethods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper
ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, getPdfObject, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease
-
Field Details
-
nameTrees
Map of thePdfNameTree
. Used for creationname tree
dictionary. -
pageLabels
Defining the page labelling for the document. -
ocProperties
The document’s optional content properties dictionary.
-
-
Constructor Details
-
PdfCatalog
CreatePdfCatalog
dictionary.- Parameters:
-
pdfObject
- the dictionary to be wrapped
-
PdfCatalog
CreatePdfCatalog
toPdfDocument
.- Parameters:
-
pdfDocument
- APdfDocument
object representing the document to which redaction applies
-
-
Method Details
-
getOCProperties
Use this method to get the Optional Content Properties Dictionary. Note that if you call this method, then thePdfDictionary
with OCProperties will be generated fromPdfOCProperties
object right before closing thePdfDocument
, so if you want to make low-level changes in Pdf structures themselves (PdfArray
,PdfDictionary
, etc), then you should address directly those objects, e.g.:PdfCatalog pdfCatalog = pdfDoc.getCatalog(); PdfDictionary ocProps = pdfCatalog.getAsDictionary(PdfName.OCProperties); // manipulate with ocProps.
Also note that this method is implicitly called when creating a new PdfLayer instance, so you should either use hi-level logic of operating with layers, or manipulate low-level Pdf objects by yourself.- Parameters:
-
createIfNotExists
- true to create new /OCProperties entry in catalog if not exists, false to return null if /OCProperties entry in catalog is not present. - Returns:
- the Optional Content Properties Dictionary
-
getDocument
GetPdfDocument
with indirect reference associated with the object.- Returns:
- the resultant dictionary
-
flush
public void flush()PdfCatalog will be flushed in PdfDocument.close(). User mustn't flush PdfCatalog!- Overrides:
-
flush
in classPdfObjectWrapper<PdfDictionary>
-
isWrappedObjectMustBeIndirect
protected boolean isWrappedObjectMustBeIndirect()Description copied from class:PdfObjectWrapper
Defines if the object behind this wrapper must be an indirect object in the resultant document.
If this method returns true it doesn't necessarily mean that object must be in the indirect state at any moment, but rather defines that when the object will be written to the document it will be transformed into indirect object if it's not indirect yet.
Return value of this method shouldn't depend on any logic, it should return always true or false.- Specified by:
-
isWrappedObjectMustBeIndirect
in classPdfObjectWrapper<PdfDictionary>
- Returns:
- true if in the resultant document the object behind the wrapper must be indirect, otherwise false.
-
setOpenAction
A value specifying an action that shall be performed when the document is opened. See ISO 32000-1, Table 28 – Entries in the catalog dictionary.- Parameters:
-
action
- instance ofPdfAction
. - Returns:
- action
-
setAdditionalAction
The actions that shall be taken in response to various trigger events affecting the document as a whole. See ISO 32000-1, Table 28 – Entries in the catalog dictionary.- Parameters:
-
key
- the key of which the associated value needs to be returned -
action
- instance ofPdfAction
. - Returns:
- additional action
-
getPageMode
Get page mode of the document.- Returns:
-
current instance of
PdfCatalog
-
setPageMode
This method sets a page mode of the document.
Valid values are:PdfName.UseNone
,PdfName.UseOutlines
,PdfName.UseThumbs
,PdfName.FullScreen
,PdfName.UseOC
,PdfName.UseAttachments
.- Parameters:
-
pageMode
- page mode. - Returns:
- current instance of PdfCatalog
-
getPageLayout
Get page layout of the document.- Returns:
- name object of page layout that shall be used when document is opened
-
setPageLayout
This method sets a page layout of the document- Parameters:
-
pageLayout
- page layout of the document - Returns:
-
PdfCatalog
instance with applied page layout
-
getViewerPreferences
Get viewer preferences of the document.- Returns:
- dictionary of viewer preferences
-
setViewerPreferences
This method sets the document viewer preferences, specifying the way the document shall be displayed on the screen- Parameters:
-
preferences
- document'sviewer preferences
- Returns:
-
PdfCatalog
instance with applied viewer preferences
-
getNameTree
This method gets Names tree from the catalog.- Parameters:
-
treeType
- type of the tree (Dests, AP, EmbeddedFiles etc). - Returns:
-
returns
PdfNameTree
-
getPageLabelsTree
This method returns the NumberTree of Page Labels- Parameters:
-
createIfNotExists
- defines whether the NumberTree of Page Labels should be created if it didn't exist before - Returns:
-
returns
PdfNumTree
-
getLang
Get natural language.- Returns:
- natural language
-
setLang
An entry specifying the natural language, and optionally locale. Use this to specify the Language attribute on a Tagged Pdf element. For the content usage dictionary, use PdfName.Language- Parameters:
-
lang
-language
to be set
-
addDeveloperExtension
Add an extensions dictionary containing developer prefix identification and version numbers for developer extensions that occur in this document. See ISO 32000-1, Table 28 – Entries in the catalog dictionary.- Parameters:
-
extension
- enables developers to identify their own extension relative to a base version of PDF
-
getCollection
Gets collection dictionary that a conforming reader shall use to enhance the presentation of file attachments stored in the PDF document.- Returns:
-
PdfCollection
wrapper of collection dictionary.
-
setCollection
Sets collection dictionary that a conforming reader shall use to enhance the presentation of file attachments stored in the PDF document.- Parameters:
-
collection
-dictionary
- Returns:
-
PdfCatalog
instance with applied collection dictionary
-
put
Add key and value toPdfCatalog
dictionary.- Parameters:
-
key
- the dictionary key corresponding with the PDF object -
value
- the value of key - Returns:
- the key and value
-
remove
Remove key from catalog dictionary.- Parameters:
-
key
- the dictionary key corresponding with the PDF object - Returns:
- the key
-
isOCPropertiesMayHaveChanged
protected boolean isOCPropertiesMayHaveChanged()True indicates that getOCProperties() was called, may have been modified, and thus its dictionary needs to be reconstructed.- Returns:
- boolean indicating if the dictionary needs to be reconstructed
-