SetaPDF_Core_Document_Page_Annotation_FileAttachment Class representing a file attachment annotation
File: /SetaPDF v2/Core/Document/Page/Annotation/FileAttachment.php
See PDF 32000-1:2008 - 12.5.6.15
Class hierarchy
Summary
Methods
- __construct()
- _getReplies()
- addReply()
- cleanUp()
- createPopup()
- getAdditionalActions()
- getAnnotationDictionary()
- getAppearance()
- getColor()
- getContents()
- getCreationDate()
- getDictionary()
- getFileSpecification()
- getHeight()
- getHiddenFlag()
- getIconName()
- getInReplyTo()
- getIndirectObject()
- getInvisibleFlag()
- getLockedContents()
- getLockedFlag()
- getModificationDate()
- getName()
- getNoRotateFlag()
- getNoViewFlag()
- getNoZoomFlag()
- getOpacity()
- getPopup()
- getPrintFlag()
- getReadOnlyFlag()
- getRect()
- getReplies()
- getSubject()
- getTextLabel()
- getToggleNoView()
- getType()
- getWidth()
- hasReplies()
- isAnnotationFlagSet()
- isReplyTo()
- setAnnotationFlags()
- setAppearance()
- setColor()
- setContents()
- setCreationDate()
- setFileSpecification()
- setHiddenFlag()
- setIconName()
- setInReplyTo()
- setInvisibleFlag()
- setLocked()
- setLockedContents()
- setModificationDate()
- setName()
- setNoRotateFlag()
- setNoViewFlag()
- setNoZoomFlag()
- setOpacity()
- setPopup()
- setPrintFlag()
- setReadOnlyFlag()
- setRect()
- setSubject()
- setTextLabel()
- setToggleNoView()
- unsetAnnotationFlags()
Constants
- ICON_GRAPH
- ICON_PAPERCLIP
- ICON_PUSH_PIN
- ICON_TAG
- TYPE_3D
- TYPE_CARET
- TYPE_CIRCLE
- TYPE_FILE_ATTACHMENT
- TYPE_FREE_TEXT
- TYPE_HIGHLIGHT
- TYPE_INK
- TYPE_LINE
- TYPE_LINK
- TYPE_MOVIE
- TYPE_POLYGON
- TYPE_POLY_LINE
- TYPE_POPUP
- TYPE_PRINTER_MARK
- TYPE_REDACT
- TYPE_SCREEN
- TYPE_SOUND
- TYPE_SQUARE
- TYPE_SQUIGGLY
- TYPE_STAMP
- TYPE_STRIKE_OUT
- TYPE_TEXT
- TYPE_TRAP_NET
- TYPE_UNDERLINE
- TYPE_WATERMARK
- TYPE_WIDGET
Constants
ICON_GRAPH
Icon name defined in PDF 32000-1:2008 - 12.5.6.15 File attachment annotations
ICON_PAPERCLIP
Icon name defined in PDF 32000-1:2008 - 12.5.6.15 File attachment annotations
ICON_PUSH_PIN
Icon name defined in PDF 32000-1:2008 - 12.5.6.15 File attachment annotations
ICON_TAG
Icon name defined in PDF 32000-1:2008 - 12.5.6.15 File attachment annotations
TYPE_3D
Annotation type
TYPE_CARET
Annotation type
TYPE_CIRCLE
Annotation type
TYPE_FILE_ATTACHMENT
Annotation type
TYPE_FREE_TEXT
Annotation type
TYPE_HIGHLIGHT
Annotation type
TYPE_INK
Annotation type
TYPE_LINE
Annotation type
TYPE_LINK
Annotation type
TYPE_MOVIE
Annotation type
TYPE_POLYGON
Annotation type
TYPE_POLY_LINE
Annotation type
TYPE_POPUP
Annotation type
TYPE_PRINTER_MARK
Annotation type
TYPE_REDACT
Annotation type
TYPE_SCREEN
Annotation type
TYPE_SOUND
Annotation type
TYPE_SQUARE
Annotation type
TYPE_SQUIGGLY
Annotation type
TYPE_STAMP
Annotation type
TYPE_STRIKE_OUT
Annotation type
TYPE_TEXT
Annotation type
TYPE_TRAP_NET
Annotation type
TYPE_UNDERLINE
Annotation type
TYPE_WATERMARK
Annotation type
TYPE_WIDGET
Annotation type
Properties
$_annotationDictionary
The annotation dictionary
Static Methods
_createAnnotationDictionary()
Creates an annotation dictionary with default values.
Parameters
- $rect : SetaPDF_Core_DataStructure_Rectangle|array
- $subtype : string
_setFileSpecification()
Ensures a valid file specification parameter.
Parameters
- $dict : SetaPDF_Core_Type_Dictionary
- $fileSpecification : SetaPDF_Core_FileSpecification|SetaPDF_Core_Type_IndirectObjectInterface|SetaPDF_Core_Type_Dictionary
byObjectOrDictionary()
Creates an annotation object by an annotation dictionary or its parent object.
Parameters
- $objectOrDictionary : SetaPDF_Core_Type_Dictionary|SetaPDF_Core_Type_IndirectObjectInterface
Exceptions
Throws SetaPDF_Core_Type_Exception
Throws InvalidArgumentException
createAnnotationDictionary()
Creates an annotation dictionary.
Parameters
- $rect : SetaPDF_Core_DataStructure_Rectangle|array
- $fileSpecification : SetaPDF_Core_FileSpecification|SetaPDF_Core_Type_IndirectObject|SetaPDF_Core_Type_Dictionary
Exceptions
Throws InvalidArgumentException
Methods
__construct()
The constructor.
Parameters
- $objectOrDictionary : array|SetaPDF_Core_Type_AbstractType|SetaPDF_Core_Type_Dictionary|SetaPDF_Core_Type_IndirectObjectInterface
Exceptions
Throws InvalidArgumentException
Throws SetaPDF_Core_Type_Exception
_getReplies()
Get all replies or checks for their existance.
Parameters
- $annotations : SetaPDF_Core_Document_Page_Annotations
- $onlyCheckForExistance : bool
Exceptions
Throws SetaPDF_Core_Type_Exception
addReply()
Adds a reply to this annotation.
Parameters
- $annotation : SetaPDF_Core_Document_Page_Annotation_Markup
createPopup()
Create a popup annotation object for this annotation.
If the x-offset value is less than zero the popup will be created at the left side of the main annotation. Otherwise on the right side. If the y-offset value is less than zero the popup will be create down below the main annotation. Otherwise above.
You need to re-add this new popup annotation to its origin annotation by passing it to
the addPopup()
method after
assigning it to the page object.
Parameters
- $offsetX : int|float
- $offsetY : int|float
- $width : int|float
- $height : int|float
Exceptions
Throws SetaPDF_Core_Type_Exception
getAdditionalActions()
Gets the additional actions object instance for this annotation.
getAnnotationDictionary()
WARNING: This method is marked as deprecated!
Get the annotation dictionary.
getAppearance()
Get the annotation appearance stream.
Parameters
- $type : string
- $subName : null|string
Exceptions
Throws InvalidArgumentException
getColor()
Get the color of the annotation.
getContents()
Get the contents of the annotation.
Parameters
- $encoding : string
getCreationDate()
Get the creation date.
The date and time when the annotation was created.Parameters
- $asString : bool
Whether receive the value as a string (PDF date string) or as a
SetaPDF_Core_DataStructure_Date
instance.
Exceptions
Throws Exception
See
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
- SetaPDF_Core_Document_Page_Annotation_Markup::setCreationDate()
getFileSpecification()
Get the file specification.
Exceptions
Throws SetaPDF_Core_Type_Exception
getHeight()
getHiddenFlag()
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."
getInReplyTo()
Get the in reply to annotation (if available).
Exceptions
Throws SetaPDF_Core_Type_Exception
See
- SetaPDF_Core_Document_Page_Annotation_Markup::setInReplyTo()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
getIndirectObject()
Get the indirect object of this annotation.
Parameters
- $document : SetaPDF_Core_Document
getInvisibleFlag()
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"
getLockedContents()
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."
getLockedFlag()
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."
getModificationDate()
Get the modification date.
Parameters
- $asString : bool
Exceptions
Throws Exception
getName()
Get the name of the annotation.
Parameters
- $encoding : string
getNoRotateFlag()
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."
getNoViewFlag()
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."
getNoZoomFlag()
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."
getPopup()
Get the associated popup object if available.
Exceptions
Throws SetaPDF_Core_Type_Exception
getPrintFlag()
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."
getReadOnlyFlag()
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"
getRect()
Get the rectangle object of this annotation.
getReplies()
Get all annotations which refer this annotation as an reply.
Parameters
- $annotations : SetaPDF_Core_Document_Page_Annotations
Exceptions
Throws SetaPDF_Core_Type_Exception
getSubject()
Get the subject.
Text representing a short description of the subject being addressed by the annotation.Parameters
- $encoding : string
See
- SetaPDF_Core_Document_Page_Annotation_Markup::setSubject()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
getTextLabel()
Get the text label.
The text label that shall be displayed in the title bar of the annotation’s pop-up window when open and active. This entry shall identify the user who added the annotation.Parameters
- $encoding : string
See
- SetaPDF_Core_Document_Page_Annotation_Markup::setTextLabel()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
getToggleNoView()
Checks for the "ToggleNoView" flag.
PDF 32000-1:2008 - Table 165: "If set, invert the interpretation of the NoView flag for certain events."
getWidth()
hasReplies()
Check whether this annotation has a reply or not.
Parameters
- $annotations : SetaPDF_Core_Document_Page_Annotations
Exceptions
Throws SetaPDF_Core_Type_Exception
setAnnotationFlags()
Sets an annotation flag.
Parameters
- $flags : integer
- $set : boolean
Set or unset
setAppearance()
Set the annotation appearance stream.
Parameters
- $xObject : SetaPDF_Core_XObject_Form
- $type : string
- $subState : string|null
setColor()
Set the color of the annotation.
Parameters
- $color : null|bool|int|float|string|array|SetaPDF_Core_DataStructure_Color
setContents()
Set the contents of the annotation.
Parameters
- $contents : string|null
- $encoding : string
setCreationDate()
Set the creation date.
Parameters
- $date : null|bool|string|DateTime|SetaPDF_Core_Type_String|SetaPDF_Core_DataStructure_Date
Exceptions
Throws Exception
See
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
- SetaPDF_Core_Document_Page_Annotation_Markup::getCreationDate()
setFileSpecification()
Set the file specification.
Parameters
- $fileSpecification : SetaPDF_Core_FileSpecification|SetaPDF_Core_Type_IndirectObject|SetaPDF_Core_Type_Dictionary
setIconName()
Set the name of the icon that shall be used in displaying the annotation.
Parameters
- $iconName : null|string
setInReplyTo()
Set the in reply to annotation object.
Parameters
- $annotation : SetaPDF_Core_Document_Page_Annotation_Markup
Exceptions
Throws InvalidArgumentException
See
- SetaPDF_Core_Document_Page_Annotation_Markup::getInReplyTo()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
setInvisibleFlag()
Set the "Invisible" flag.
Parameters
- $invisible : boolean
See
setLockedContents()
Set the "LockedContents" flag.
Parameters
- $lockedContents : boolean
See
setModificationDate()
Set the modification date.
Parameters
- $date : SetaPDF_Core_DataStructure_Date|DateTime|string|bool
If true is passed, the current date and time will be used.
Exceptions
Throws Exception
setName()
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
setNoRotateFlag()
Set the "NoRotate" flag.
Parameters
- $noRotate : boolean
See
setPopup()
Set the pop-up annotation object.
Parameters
- $annotation : SetaPDF_Core_Document_Page_Annotation_Popup
Exceptions
Throws InvalidArgumentException
setReadOnlyFlag()
Set the "ReadOnly" flag.
Parameters
- $readOnly : boolean
See
setRect()
setSubject()
Get the subject.
Parameters
- $subject : string|null
- $encoding : string
See
- SetaPDF_Core_Document_Page_Annotation_Markup::getSubject()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
setTextLabel()
Set the text label.
Parameters
- $textLabel : string|null
- $encoding : string
See
- SetaPDF_Core_Document_Page_Annotation_Markup::getTextLabel()
- PDF 32000-1:2008 - 12.5.6.2 - Table 170
setToggleNoView()
Set the "ToggleNoView" flag.
Parameters
- $toggleNoView : boolean