com.lowagie.text.pdf
public class PdfDictionary extends PdfObject
PdfDictionary is the Pdf dictionary object.
A dictionary is an associative table containing pairs of objects.
The first element of each pair is called the key and the second
element is called the value.
Unlike dictionaries in the PostScript language, a key must be a
PdfName.
A value can be any kind of PdfObject, including a dictionary.
A dictionary is generally used to collect and tie together the attributes
of a complex object, with each key-value pair specifying the name and value
of an attribute.
A dictionary is represented by two left angle brackets (<<), followed by a
sequence of key-value pairs, followed by two right angle brackets (>>).
This object is described in the 'Portable Document Format Reference Manual
version 1.7' section 3.2.6 (page 59-60).
See Also: PdfObject PdfName BadPdfFormatException
| Field Summary | |
|---|---|
| static PdfName | CATALOG This is a possible type of dictionary |
| PdfName | dictionaryType This is the type of this dictionary |
| static PdfName | FONT This is a possible type of dictionary |
| protected HashMap | hashMap This is the hashmap that contains all the values and keys of the dictionary |
| static PdfName | OUTLINES This is a possible type of dictionary |
| static PdfName | PAGE This is a possible type of dictionary |
| static PdfName | PAGES This is a possible type of dictionary |
| Constructor Summary | |
|---|---|
| PdfDictionary()
Constructs an empty PdfDictionary-object. | |
| PdfDictionary(PdfName type)
Constructs a PdfDictionary-object of a certain type.
| |
| Method Summary | |
|---|---|
| boolean | contains(PdfName key)
Returns true if this PdfDictionary contains a
mapping for the specified key.
|
| PdfObject | get(PdfName key)
Returns the PdfObject associated to the specified
key.
|
| PdfArray | getAsArray(PdfName key)
Returns a PdfObject as a PdfArray,
resolving indirect references.
|
| PdfBoolean | getAsBoolean(PdfName key)
Returns a PdfObject as a PdfBoolean,
resolving indirect references.
|
| PdfDictionary | getAsDict(PdfName key)
Returns a PdfObject as a PdfDictionary,
resolving indirect references.
|
| PdfIndirectReference | getAsIndirectObject(PdfName key)
Returns a PdfObject as a PdfIndirectReference.
|
| PdfName | getAsName(PdfName key)
Returns a PdfObject as a PdfName,
resolving indirect references.
|
| PdfNumber | getAsNumber(PdfName key)
Returns a PdfObject as a PdfNumber,
resolving indirect references.
|
| PdfStream | getAsStream(PdfName key)
Returns a PdfObject as a PdfStream,
resolving indirect references.
|
| PdfString | getAsString(PdfName key)
Returns a PdfObject as a PdfString,
resolving indirect references.
|
| PdfObject | getDirectObject(PdfName key)
Returns the PdfObject associated to the specified
key, resolving a possible indirect reference to a direct
object.
|
| Set | getKeys()
Get all keys that are set.
|
| boolean | isCatalog()
Checks if a Dictionary is of the type CATALOG.
|
| boolean | isFont()
Checks if a Dictionary is of the type FONT.
|
| boolean | isOutlineTree()
Checks if a Dictionary is of the type OUTLINES.
|
| boolean | isPage()
Checks if a Dictionary is of the type PAGE.
|
| boolean | isPages()
Checks if a Dictionary is of the type PAGES.
|
| void | merge(PdfDictionary other) |
| void | mergeDifferent(PdfDictionary other) |
| void | put(PdfName key, PdfObject object)
Associates the specified PdfObject as value with
the specified PdfName as key in this map.
|
| void | putAll(PdfDictionary dic)
Copies all of the mappings from the specified PdfDictionary
to this PdfDictionary.
|
| void | putEx(PdfName key, PdfObject value)
Associates the specified PdfObject as value to the
specified PdfName as key in this map.
|
| void | remove(PdfName key)
Removes a PdfObject and its key from the
PdfDictionary.
|
| int | size()
Returns the number of key-value mappings in this
PdfDictionary.
|
| void | toPdf(PdfWriter writer, OutputStream os)
Writes the PDF representation of this PdfDictionary as an
array of byte to the given OutputStream.
|
| String | toString()
Returns a string representation of this PdfDictionary.
|
PdfDictionary-object.PdfDictionary-object of a certain type.
Parameters: type a PdfName
true if this PdfDictionary contains a
mapping for the specified key.
Returns: true if the key is set, otherwise false.
PdfObject associated to the specified
key.
Parameters: key a PdfName
Returns: the PdfObject previously associated to the key
PdfObject as a PdfArray,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfArray, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfArray object,
or null
PdfObject as a PdfBoolean,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfBoolean, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfBoolean object,
or null
PdfObject as a PdfDictionary,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfDictionary, it is cast down and returned as
such. Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfDictionary object,
or null
PdfObject as a PdfIndirectReference.
The object associated with the PdfName given is retrieved
If it is a PdfIndirectReference, it is cast down and returned
as such. Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfIndirectReference object,
or null
PdfObject as a PdfName,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfName, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfName object,
or null
PdfObject as a PdfNumber,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfNumber, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfNumber object,
or null
PdfObject as a PdfStream,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfStream, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfStream object,
or null
PdfObject as a PdfString,
resolving indirect references.
The object associated with the PdfName given is retrieved
and resolved to a direct object.
If it is a PdfString, it is cast down and returned as such.
Otherwise null is returned.
Parameters: key A PdfName
Returns: the associated PdfString object,
or null
PdfObject associated to the specified
key, resolving a possible indirect reference to a direct
object.
This method will never return a PdfIndirectReference
object.
Parameters: key A key for the PdfObject to be returned
Returns: A direct PdfObject or null
Returns: true if it is, otherwise false.
Dictionary is of the type CATALOG.
Returns: true if it is, otherwise false.
Dictionary is of the type FONT.
Returns: true if it is, otherwise false.
Dictionary is of the type OUTLINES.
Returns: true if it is, otherwise false.
Dictionary is of the type PAGE.
Returns: true if it is, otherwise false.
Dictionary is of the type PAGES.
Returns: true if it is, otherwise false.
PdfObject as value with
the specified PdfName as key in this map.
If the map previously contained a mapping for this key, the
old value is replaced. If the value is
null or PdfNull the key is deleted.
Parameters: key a PdfName object the PdfObject to be associated with the
key
PdfDictionary
to this PdfDictionary.
These mappings will replace any mappings previously contained in this
PdfDictionary.
Parameters: dic The PdfDictionary with the mappings to be
copied over
PdfObject as value to the
specified PdfName as key in this map.
If the value is a PdfNull, it is treated just as
any other PdfObject. If the value is
null however nothing is done.
Parameters: key a PdfName value the PdfObject to be associated to the
key
PdfObject and its key from the
PdfDictionary.
Parameters: key a PdfName
PdfDictionary.
Returns: the number of key-value mappings in this
PdfDictionary.
PdfDictionary as an
array of byte to the given OutputStream.
Parameters: writer for backwards compatibility os the OutputStream to write the bytes to.
Throws: IOException
PdfDictionary.
The string doesn't contain any of the content of this dictionary.
Rather the string "dictionary" is returned, possibly followed by the
type of this PdfDictionary, if set.
Returns: the string representation of this PdfDictionary
See Also: toString