Annotation Class
The base annotation class extended by all available annotation implementations
Introduction
All annotation classes will extend the SetaPDF_Core_Document_Page_Annotation
class.
Methods
This basis class offers several getter and setter methods allowing you to access all common annotation data:
Gets the additional actions object instance for this annotation.
Description
Gets the additional actions object instance for this annotation.
Get the annotation appearance stream.
Description
Get the annotation appearance stream.
Parameters
- $type : string
-
- $subName : null|string
-
Exceptions
Throws InvalidArgumentException
Get the color of the annotation.
Description
Get the color of the annotation.
Get the contents of the annotation.
Description
Get the contents of the annotation.
Parameters
- $encoding : string
-
Get the annotation dictionary.
Description
Get the annotation dictionary.
Get the height of the annotation.
Checks for the "Hidden" flag.
Description
Checks for the "Hidden" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not display or print the annotation or allow it to interact with
the user, regardless of its annotation type or whether an annotation handler
is available."
Checks for the "Invisible" flag.
Description
Checks for the "Invisible" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not display the annotation if it does not belong to one of the
standard annotation types and no annotation handler is available. If clear,
display such an unknown annotation using an appearance stream specified by
its appearance dictionary, if any"
Checks for the "LockedContents" flag.
Description
Checks for the "LockedContents" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not allow the contents of the annotation to be modified by the
user. This flag does not restrict deletion of the annotation or changes to
other annotation properties, such as position and size."
Checks the "Locked" flag.
Description
Checks the "Locked" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not allow the annotation to be deleted or its properties (including
position and size) to be modified by the user. However, this flag does not
restrict changes to the annotation’s contents, such as the value of a form field."
Get the modification date.
Description
Get the modification date.
Parameters
- $asString : bool
-
Exceptions
Throws Exception
Get the name of the annotation.
Description
Get the name of the annotation.
Parameters
- $encoding : string
-
Checks fo the "NoRotate" flag.
Description
Checks fo the "NoRotate" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not rotate the annotation’s appearance to match the rotation of the
page. The upper-left corner of the annotation rectangle shall remain in a fixed
location on the page, regardless of the page rotation."
Checks for the "NoView" flag.
Description
Checks for the "NoView" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not display the annotation on the screen or allow it to interact
with the user. The annotation may be printed (depending on the setting of the
Print flag) but should be considered hidden for purposes of on-screen display
and user interaction."
Checks fo the "NoZoom" flag.
Description
Checks fo the "NoZoom" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not scale the annotation’s appearance to match the magnification
of the page. The location of the annotation on the page (defined by the upper-
left corner of its annotation rectangle) shall remain fixed, regardless of the
page magnification."
Checks for the "Print" flag.
Description
Checks for the "Print" flag.
PDF 32000-1:2008 - Table 165:
"If set, print the annotation when the page is printed. If clear, never print
the annotation, regardless of whether it is displayed on the screen."
Checks the "ReadOnly" flag.
Description
Checks the "ReadOnly" flag.
PDF 32000-1:2008 - Table 165:
"If set, do not allow the annotation to interact with the user. The annotation
may be displayed or printed (depending on the settings of the NoView and Print
flags) but should not respond to mouse clicks or change its appearance in
response to mouse motions.
This flag shall be ignored for widget annotations; its function is subsumed by
the ReadOnly flag of the associated form field"
Get the rectangle object of this annotation.
Description
Get the rectangle object of this annotation.
Checks for the "ToggleNoView" flag.
Description
Checks for the "ToggleNoView" flag.
PDF 32000-1:2008 - Table 165:
"If set, invert the interpretation of the NoView flag for certain events."
Get the width of the annotation.
Set the annotation appearance stream.
Description
Set the annotation appearance stream.
Parameters
- $xObject : SetaPDF_Core_XObject_Form
-
- $type : string
-
- $subState : string|null
-
Set the color of the annotation.
Set the contents of the annotation.
Description
Set the contents of the annotation.
Parameters
- $contents : string|null
-
- $encoding : string
-
Set the "Hidden" flag.
Description
Set the "Hidden" flag.
Parameters
- $hidden : boolean
-
See
Set the "Invisible" flag.
Description
Set the "Invisible" flag.
Parameters
- $invisible : boolean
-
See
Set the "Locked" flag.
Description
Set the "Locked" flag.
Parameters
- $locked : boolean
-
See
Set the "LockedContents" flag.
Description
Set the "LockedContents" flag.
Parameters
- $lockedContents : boolean
-
See
Set the modification date.
Set the name of the annotation.
Description
Set the name of the annotation.
The annotation name, a text string uniquely identifying it among all the annotations on its page.
Parameters
- $name : string|null
-
- $encoding : string
-
Set the "NoRotate" flag.
Description
Set the "NoRotate" flag.
Parameters
- $noRotate : boolean
-
See
Set the "NoView" flag.
Description
Set the "NoView" flag.
Parameters
- $noView : boolean
-
See
Set the "NoZoom" flag.
Description
Set the "NoZoom" flag.
Parameters
- $noZoom : boolean
-
See
Set the "Print" flag.
Description
Set the "Print" flag.
Parameters
- $print : boolean
-
See
Set the "ReadOnly" flag.
Description
Set the "ReadOnly" flag.
Parameters
- $readOnly : boolean
-
See
Set the rectangle object.
Set the "ToggleNoView" flag.
Description
Set the "ToggleNoView" flag.
Parameters
- $toggleNoView : boolean
-
See