pdf viewer control in asp net c# : Add jpeg to pdf Library application component .net azure winforms mvc PDF32000_200843-part2362

© 
Adobe Systems Incorporated 2008 – All rights reserved
423
PDF 32000-1:2008
12.6.4.6
Thread Actions
thread action  jumps  to a specified bead on  an  article  thread (see 12.4.3, “Articles”), in either the current 
document or a different one. Table 205 shows the action dictionary entries specific to this type of action. 
12.6.4.7
URI Actions
uniform resource identifier (URI) is a string that identifies (resolves to) a resource on the Internet—typically a 
file that is the destination of a hypertext link, although it may also resolve to a query or other entity. (URIs are 
described in Internet RFC 2396, Uniform Resource Identifiers (URI): Generic Syntax; see the Bibliography.) 
URI action causes a URI to be resolved. Table 206 shows the action dictionary entries specific to this type of 
action. 
D
byte string 
(Optional) A bye string specifying the default directory in standard 
DOS syntax. 
O
ASCII string
(Optional) An ASCII string specifying the operation to perform: 
open Open a document. 
print Print a document. 
If the F entry designates an application instead of a document, this 
entry shall be ignored and the application shall be launched. Default 
value: open. 
P
byte string
(Optional) A parameter string that shall be passed to the application 
designated by the F entry. This entry shall be omitted if F designates a 
document. 
Table 205 –  Additional entries specific to a thread action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be 
Thread for a thread action. 
F
file specification
(Optional) The file containing the thread. If this entry is absent, the 
thread is in the current file. 
D
dictionary, integer, or 
text string
(Required) The destination thread, specified in one of the following 
forms: 
An indirect reference to a thread dictionary (see 12.4.3, “Articles”). In 
this case, the thread shall be in the current file. 
The index of  the thread  within  the Threads  array of its document’s 
Catalog (see 7.7.2, “Document Catalog”). The first thread in the array 
has index 0. 
The title of the thread as specified in its thread information dictionary 
(see Table 160). If two or more threads have the same title, the one 
appearing  first  in  the  document Catalog’s Threads  array  shall  be
used. 
B
dictionary or integer
(Optional) The bead in the destination thread, specified in one of the 
following forms: 
An indirect reference to a bead dictionary (see 12.4.3, “Articles”). In 
this case, the thread shall be in the current file. 
The index of the bead within its thread. The first bead in a thread has 
index 0. 
Table 204 –  Entries in a Windows launch parameter dictionary  (continued)
Key
Type
Value
Add jpeg to pdf - insert images into PDF in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Sample C# code to add image, picture, logo or digital photo into PDF document page using PDF page editor control
adding an image to a pdf file; add jpg to pdf preview
Add jpeg to pdf - VB.NET PDF insert image library: insert images into PDF in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide VB.NET Programmers How to Add Images in PDF Document
add jpeg signature to pdf; add jpeg to pdf
PDF 32000-1:2008
424
© 
Adobe Systems Incorporated 2008 – All rights reserved
If the IsMap  flag is true  and the user has triggered the URI action by clicking an annotation, the coordinates of 
the mouse position at the time the action has been triggered shall be transformed from device space to user 
space and then offset relative to the upper-left corner of the annotation rectangle (that is, the value of the Rect
entry in the annotation with which the URI action is associated). 
EXAMPLE 1
If the mouse coordinates in user space are (x
m
y
m
) and the annotation rectangle extends from (ll
ll
y
) at 
the lower-left to (ur
x
ur
y
) at the upper-right, the final coordinates (x
f
y
) are as follows: 
If the resulting coordinates (x
f 
y
f
) are fractional, they shall be rounded to the nearest integer values. They shall 
then be appended to the URI to be resolved, separated by COMMAS (2Ch) and preceded by a QUESTION 
MARK (3Fh), as shown in this example: 
EXAMPLE 2
http : / / www . adobe . com / intro ?100 , 200
NOTE 1
To support URI actions, a PDF document’s Catalog (see 7.7.2, “Document Catalog”) may include a URI entry 
whose value is a URI dictionary. Only one entry shall be defined for such a dictionary (see Table 207). 
NOTE 2
The Base entry allows the URI of the document to be recorded in situations in which the document may be 
accessed out of context. For example, if a document has been moved to a new location but contains relative 
links to other documents that have not been moved, the Base entry could be used to refer such links to the 
true location of the other documents, rather than that of the moved document. 
Table 206 –  Additional entries specific to a URI action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be URI for a 
URI action. 
URI
ASCII 
string
(Required) The uniform resource identifier to resolve, encoded in 7-bit ASCII. 
IsMap
boolean
(Optional) A flag specifying whether to track the mouse position when the URI 
is resolved (see the discussion following this Table). Default value: false . 
This  entry  applies  only  to  actions  triggered  by  the  user’s  clicking  an 
annotation; it shall be ignored for actions associated with outline items or with 
a document’s OpenAction entry. 
Table 207 –  Entry in a URI dictionary  
Key
Type
Value
Base
ASCII 
string
(Optional) The  base  URI that shall be used in resolving relative URI 
references. URI actions within the document may specify URIs in partial form, 
to be  interpreted relative to this base address. If  no base URI is specified, 
such partial URIs shall be interpreted relative to the location of the document 
itself. The use of this entry is parallel to that of the body element <BASE >, as 
described in the HTML 4.01 Specification (see the Bibliography). 
x
f
x
m
ll
x
( =
)
y
f
ur
y
y
m
=
VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.
Convert PDF to JPEG Using VB.NET. Add necessary references: RasterEdge.Imaging.Basic. dll. RasterEdge.Imaging.Basic.Codec.dll. RasterEdge.Imaging.Drawing.dll.
add jpg to pdf document; how to add image to pdf reader
C# PDF Convert to Jpeg SDK: Convert PDF to JPEG images in C#.net
Convert PDF to JPEG Using C#.NET. Add necessary references: RasterEdge.Imaging.Basic. dll. RasterEdge.Imaging.Basic.Codec.dll. RasterEdge.Imaging.Drawing.dll.
adding images to pdf forms; add picture to pdf document
© 
Adobe Systems Incorporated 2008 – All rights reserved
425
PDF 32000-1:2008
12.6.4.8
Sound Actions
sound action (PDF 1.2)  plays  a  sound  through  the  computer’s  speakers.  Table 208  shows  the  action 
dictionary entries specific to this type of action. Sounds are discussed in 13.3, “Sounds.”
12.6.4.9
Movie Actions
movie action (PDF 1.2) can be used to play a movie in a floating window or within the annotation rectangle of 
a movie annotation (see 12.5.6.17, “Movie Annotations” and 13.4, “Movies”). The movie annotation shall be 
associated  with the  page  that  is  the destination  of the link annotation  or  outline  item  containing  the  movie 
action, or with the page object with which the action is associated. 
NOTE
A movie action by itself does not guarantee that the page the movie is on will be displayed before attempting to 
play the movie; such page change actions shall be done explicitly. 
The contents of a movie action dictionary are identical to those of a movie activation dictionary (see Table 296), 
with the additional entries  shown in Table 209. The contents of the activation dictionary associated with the 
movie annotation provide the default values. Any information specified in the movie action dictionary overrides 
these values. 
Table 208 –  Additional entries specific to a sound action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be 
Sound for a sound action. 
Sound
stream
(Required) A sound object defining the sound that shall be played (see 
13.3, “Sounds”). 
Volume
number
(Optional) The volume at which to play the sound, in the range 
1.0 to 
1.0. Default value: 1.0. 
Synchronous
boolean
(Optional) A flag specifying whether to play the sound synchronously 
or asynchronously. If this flag is true , the conforming reader retains 
control, allowing no further user interaction other than canceling the 
sound,  until  the  sound  has  been  completely  played. Default  value: 
false
Repeat
boolean
(Optional) A flag specifying whether to repeat the sound indefinitely. If 
this entry is present, the Synchronous entry shall be ignored. Default 
value: false . 
Mix
boolean
(Optional) A flag specifying whether to mix this sound with any other 
sound  already  playing.  If  this  flag  is false ,  any  previously  playing 
sound shall be stopped before starting this sound; this can be used to 
stop a repeating sound (see Repeat). Default value: false . 
Table 209 –  Additional entries specific to a movie action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be Movie
for a movie action. 
Annotation
dictionary
(Optional) An indirect reference to a movie annotation identifying the movie 
that shall be played. 
T
text string
(Optional) The title of a movie annotation identifying the movie that shall be
played. 
The dictionary shall include either an Annotation or a T entry but not both. 
VB.NET PDF Password Library: add, remove, edit PDF file password
VB: Add Password to PDF with Permission Settings Applied. This VB.NET example shows how to add PDF file password with access permission setting.
how to add a jpeg to a pdf; adding images to pdf files
C# PDF Password Library: add, remove, edit PDF file password in C#
C# Sample Code: Add Password to PDF with Permission Settings Applied in C#.NET. This example shows how to add PDF file password with access permission setting.
add picture to pdf reader; add jpg to pdf online
PDF 32000-1:2008
426
© 
Adobe Systems Incorporated 2008 – All rights reserved
12.6.4.10
Hide Actions
hide action (PDF 1.2) hides or  shows  one or more annotations on the screen by  setting or clearing their 
Hidden flags (see 12.5.3, “Annotation Flags”). This type of action can be used in combination with appearance 
streams and trigger events (Sections 12.5.5, “Appearance Streams,” and 12.6.3, “Trigger Events”) to display 
pop-up help information on the screen. 
NOTE
The E (enter) and X (exit) trigger events in an annotation’s additional-actions dictionary can be used to show 
and hide the annotation when the user rolls the cursor in and out of its active area on the page. This can be 
used to pop up a help label, or tool tip, describing the effect of clicking at that location on the page.
Table 210 shows the action dictionary entries specific to this type of action. 
12.6.4.11
Named Actions
Table 211 lists several named actions (PDF 1.2) that conforming readers shall support; further names may be 
added in the future. 
Operation
name
(Optional) The operation that shall be performed on the movie: 
PlayStart  playing  the  movie,  using  the  play  mode  specified  by  the 
dictionary’s Mode entry (see Table 296). If the movie is currently paused, it 
shall be repositioned to the beginning before playing (or to the starting point 
specified by the dictionary’s Start entry, if present). 
Stop
Stop playing the movie. 
Pause
Pause a playing movie. 
Resume
Resume a paused movie. 
Default value: Play. 
Table 210 –  Additional entries specific to a hide action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be Hide for 
a hide action. 
T
dictionary, 
text  string,  or 
array
(Required) The annotation or annotations to be hidden or shown, shall be
specified in any of the following forms: 
An indirect reference to an annotation dictionary 
A text string giving the fully qualified field name of an interactive form field 
whose associated widget annotation or annotations are to be affected (see 
12.7.3.2, “Field Names”) 
An array of such dictionaries or text strings 
H
boolean
(Optional) A flag indicating whether to hide the annotation (true) or show it 
(false). Default value: true. 
Table 211 –  Named actions  
Name
Action
NextPage
Go to the next page of the document. 
PrevPage
Go to the previous page of the document. 
FirstPage
Go to the first page of the document. 
LastPage
Go to the last page of the document. 
Table 209 –  Additional entries specific to a movie action  (continued)
Key
Type
Value
C# PDF Sticky Note Library: add, delete, update PDF note in C#.net
C#.NET PDF SDK - Add Sticky Note to PDF Page in C#.NET. Able to add notes to PDF using C# source code in Visual Studio .NET framework.
add photo pdf; add image to pdf acrobat reader
C# PDF File & Page Process Library SDK for C#.net, ASP.NET, MVC
C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# C# Read: PDF Image Extract; C# Write: Insert text into PDF; C# Write: Add Image to
acrobat insert image in pdf; how to add image to pdf in preview
© 
Adobe Systems Incorporated 2008 – All rights reserved
427
PDF 32000-1:2008
NOTE
Conforming readers may support additional, nonstandard named actions, but any document using them is not 
portable. If the viewer encounters a named action that is inappropriate for a viewing platform, or if the viewer 
does not recognize the name, it shall take no action. 
Table 212 shows the action dictionary entries specific to named actions. 
12.6.4.12
Set-OCG-State Actions
set-OCG-state action (PDF 1.5) sets the state of one or more optional content groups (see 8.11, “Optional 
Content”). Table 213 shows the action dictionary entries specific to this type of action.
When a set-OCG-state action is performed, the State array shall be processed from left to right. Each name 
shall  be  applied  to  subsequent  groups  in  the  array  until  the  next  name  is  encountered,  as  shown  in  the 
following example.
EXAMPLE 1
<< /S /SetOCGState
/State [/OFF 2 0 R 3 0 R /Toggle 16 0 R 19 0 R /ON 5 0 R]
>>
A group may appear more than once in the State array; its state shall be set each time it is encountered, based 
on the most recent name. ONOFF and Toggle sequences have no required order. More than one sequence in 
the array may contain the same name.
EXAMPLE 2
If the array contained [/OFF 1 0 R /Toggle 1 0 R], the group’s state would be ON after the action was 
performed.
Table 212 –  Additional entries specific to named actions  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be Named for a 
named action. 
N
name
(Required) The name of the action that shall be performed (see Table 211). 
Table 213 –  Additional entries specific to a set-OCG-state action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be 
SetOCGState for a set-OCG-state action.
State
array
(Required) An array consisting of any number of sequences beginning with a 
name object (ON, OFF, or Toggle) followed by one or more optional content 
group dictionaries. The array elements shall be processed from left to right; 
each name shall be applied to the subsequent groups until the next name is 
encountered:
ON 
sets the state of subsequent groups to ON
OFF 
sets the state of subsequent groups to OFF
Toggle reverses the state of subsequent groups.
PreserveRB
boolean
(Optional) If true, indicates that radio-button state relationships between 
optional content groups (as specified by the RBGroups entry in the current 
configuration  dictionary;  see  Table 101)  should  be  preserved  when  the 
states in the State array are applied. That is, if a group is set to ON (either by 
ON or  Toggle) during processing of the  State array, any other groups 
belonging to the same radio-button group shall be turned OFF. If a group is 
set to OFF, there is no effect on other groups.
If PreserveRB  is false ,  radio-button  state  relationships,  if  any,  shall  be
ignored.
Default value: true.
C# PDF Digital Signature Library: add, remove, update PDF digital
C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# C# Read: PDF Image Extract; C# Write: Insert text into PDF; C# Write: Add Image to
how to add a picture to a pdf file; add png to pdf preview
C# Create PDF from images Library to convert Jpeg, png images to
Load 3 image files (BMP, JPEG and PNG Bitmap(Program.RootPath + "\\" 1.jpg")); images.Add(new Bitmap RootPath + "\\" 1.png")); / Build a PDF document with
add image to pdf file acrobat; add photo to pdf online
PDF 32000-1:2008
428
© 
Adobe Systems Incorporated 2008 – All rights reserved
NOTE
While the specification allows a group to appear more than once in the State array, this is not intended to 
implement  animation or any other sequential drawing operations.  PDF processing applications  are free to 
accumulate all state changes and apply only the net changes simultaneously to all affected groups before 
redrawing.
12.6.4.13
Rendition Actions
rendition action (PDF 1.5) controls the playing of multimedia content (see 13.2, “Multimedia”). This action 
may be used in the following ways: 
To begin the playing of a rendition object (see 13.2.3, “Renditions”), associating it with a screen annotation 
(see 12.5.6.18, “Screen Annotations”). The screen annotation specifies where the rendition shall be played 
unless otherwise specified.
To stop, pause, or resume a playing rendition.
To trigger the execution of a JavaScript script that may perform custom operations.
Table 214 lists the entries in a rendition action dictionary.
Either the JS entry or the OP entry shall be present. If both are present, OP is considered a fallback that shall 
be executed if the conforming reader is unable to execute JavaScripts. If OP has an unrecognized value and 
there is no JS entry, the action is invalid.
Table 214 –  Additional entries specific to a rendition action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be Rendition
for a rendition action.
R
dictionary
(Required when OP is present with a value of 0 or 4; otherwise optional) A 
rendition object (see 13.2.3, “Renditions”). 
AN
dictionary
(Required if OP is present with a value of 0, 1, 2, 3 or 4; otherwise optional) An 
indirect  reference  to  a  screen  annotation  (see  12.5.6.18,  “Screen 
Annotations”).
OP
integer
(Required if JS is not present; otherwise optional) The operation to perform 
when the action is triggered. Valid values shall be:
0
If no rendition is associated with the annotation specified by AN, play the 
rendition specified by R, associating it with the annotation. If a rendition 
is already associated with the annotation, it shall be stopped, and the 
new rendition shall be associated with the annotation. 
1
Stop  any  rendition  being  played  in  association  with  the  annotation 
specified by AN, and  remove the association.  If  no rendition  is  being 
played, there is no effect. 
2
Pause  any  rendition  being  played  in  association  with  the  annotation 
specified b y AN. If no rendition is being played, there is no effect.
3
Resume any rendition being played  in association with the annotation 
specified by AN. If no rendition is being played or the rendition is not 
paused, there is no effect.
4
Play  the  rendition  specified  by R,  associating  it  with  the  annotation 
specified by AN. If a rendition is already associated with the annotation, 
resume the rendition if it is paused; otherwise, do nothing.
JS
text string 
or stre
am
(Required if OP is not present; otherwise optional) A  text  string  or  stream 
containing  a  JavaScript  script  that  shall  be  executed  when  the  action  is 
triggered.
© 
Adobe Systems Incorporated 2008 – All rights reserved
429
PDF 32000-1:2008
In some situations, a pause (OP value of 2) or resume (OP value of 3) operation may not make sense or the 
player may not support it. In such cases, the user should be notified of the failure to perform the operation.
EXAMPLE
A JPEG image
Before a rendition action is executed,  the conforming reader shall make sure that the P entry of the screen 
annotation  dictionary references  a valid page  object  and that the annotation is present in  the  page object’s 
Annots array (see Table 30). 
A rendition may play in the rectangle occupied by a screen annotation, even if the annotation itself is not visible; 
for example, if its Hidden or NoView flags (see Table 165) are set. If a screen annotation is not visible because 
its location  on  the  page is  not being  displayed  by  the  viewer,  the  rendition  is  not  visible.  However,  it may 
become visible if the view changes, such as by scrolling.
12.6.4.14
Transition Actions
transition action (PDF 1.5) may be used to control drawing during a sequence of actions. As discussed in 
12.6.2,  “Action  Dictionaries,”  the Next  entry  in  an  action  dictionary  may  specify  a  sequence  of  actions. 
Conforming readers shall normally suspend drawing when such a sequence begins and resume drawing when 
it ends. If a transition action is present during a sequence, the conforming reader shall render the state of the 
page viewing area as it exists after completion of the previous action and display it using a transition specified 
in the action dictionary (see Table 215). Once this transition completes, drawing shall be suspended again.
12.6.4.15
Go-To-3D-View Actions
go-to-3D-view action (PDF 1.6) identifies a 3D annotation and specifies a view for the annotation to use (see 
13.6, “3D Artwork”). Table 216 shows the entries in a go-to-3D-view action dictionary. 
The V entry selects the view to apply to the annotation specified by TA. This view may be one of the predefined 
views specified by the VA entry of the 3D stream (see Table 300) or a unique view specified here. 
Table 215 –  Additional entries specific to a transition action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be Trans
for a transition action. 
Trans
dictionary
(Required) The transition to use for the update of the display (see 
Table 162).
Table 216 –  Additional entries specific to a go-to-3D-view action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be 
GoTo3DView for a transition action. 
TA
dictionary
(Required) The target annotation for which to set the view.
V
(various)
(Required) The view to use. It may be one of the following types:
A 3D view dictionary (see 13.6.4, “3D Views”).
An  integer  specifying  an  index  into  the VA  array  in  the 3D  stream  (see 
Table 300).
A text string matching the IN  entry in one of the views in the VA array (see 
Table 304).
A name that indicates the first (F), last (L), next (N), previous (P), or default 
(D) entries in the VA array; see discussion following this Table.
PDF 32000-1:2008
430
© 
Adobe Systems Incorporated 2008 – All rights reserved
If the predefined view is specified by the names N (next) or P (previous), it should be interpreted in the following 
way:
When the last view applied was specified by means of the VA array, N and P indicate the next and previous 
entries, respectively, in the VA array (wrapping around if necessary).
When the last view was not specified by means of VA, using N or P should result in reverting to the default 
view. 
12.6.4.16
JavaScript Actions
Upon invocation  of a JavaScript  action,  a  conforming processor shall  execute a script that  is written  in  the 
JavaScript programming language. Depending on the nature of the script, various interactive form fields in the 
document may update their values or change their visual appearances. Mozilla Development Center’s Client-
Side JavaScript Reference and the Adobe JavaScript for Acrobat API Reference (see the Bibliography) give 
details on the contents and effects of JavaScript scripts. Table 217 shows the action dictionary entries specific 
to this type of action. 
To  support  the  use  of  parameterized  function  calls  in  JavaScript  scripts,  the JavaScript  entry  in  a  PDF 
document’s name dictionary (see 7.7.4, “Name Dictionary”) may contain a name tree that maps name strings to 
document-level JavaScript actions. When the document is opened, all of the actions in this name tree shall be 
executed, defining JavaScript functions for use by other scripts in the document. 
NOTE
The name  strings associated with  individual JavaScript  actions in  the name dictionary serve merely as a 
convenient  means  for organizing and  packaging  scripts.  The names are arbitrary  and need not bear  any 
relation to the JavaScript name space. 
12.7
Interactive Forms
12.7.1
General
An interactive form (PDF 1.2)—sometimes referred to as an AcroForm—is a collection of fields  for gathering 
information interactively from the user. A PDF document may contain any number of fields appearing on any 
combination of  pages,  all of  which make up a  single,  global interactive form spanning the entire document. 
Arbitrary subsets of these fields can be imported or exported from the document; see 12.7.5, “Form Actions.” 
NOTE 1
Interactive  forms  should  not  be  confused  with  form  XObjects  (see  8.10,  “Form  XObjects”).  Despite  the 
similarity of names, the two are different, unrelated types of objects. 
Each  field  in  a  document’s  interactive  form  shall  be  defined  by  a field dictionary   (see  12.7.3,  “Field 
Dictionaries”). For purposes of definition and naming, the fields can be organized hierarchically and can inherit 
attributes from their ancestors in the field hierarchy. A field’s children in the hierarchy may also include widget 
annotations (see  12.5.6.19,  “Widget  Annotations”) that define its appearance on  the  page.  A  field  that  has 
children that are fields is called a non-terminal field. A field that does not have children that are fields is called a 
terminal field.
Table 217 –  Additional entries specific to a JavaScript action  
Key
Type
Value
S
name
(Required) The type of action that this dictionary describes; shall be 
JavaScript for a JavaScript action. 
JS
text string or 
text stream
(Required) A text string or text stream containing the JavaScript script to 
be executed. 
PDFDocEncoding or Unicode encoding (the latter identified by the 
Unicode  prefix U+ FEFF )  shall be used  to  encode  the  contents  of the 
string or stream. 
© 
Adobe Systems Incorporated 2008 – All rights reserved
431
PDF 32000-1:2008
A terminal field may have children that are widget annotations (see 12.5.6.19, “Widget Annotations“) that define 
its appearance on the page. As a convenience, when a field has only a single associated widget annotation, the 
contents of the field dictionary and the annotation dictionary (12.5.2, “Annotation Dictionaries”) may be merged 
into  a  single  dictionary containing  entries  that  pertain  to  both  a  field and  an  annotation.  (This  presents  no 
ambiguity,  since  the  contents  of  the two  kinds  of  dictionaries  do not  conflict.)  If  such  an  object  defines  an 
appearance stream, the appearance shall be consistent with the object’s current value as a field.
NOTE 2
Fields  containing  text whose contents are not known  in advance may  need  to construct  their appearance 
streams dynamically instead of defining them statically in an appearance dictionary; see 12.7.3.3, “Variable 
Text.”
12.7.2
Interactive Form Dictionary
The contents and properties of a document’s interactive form shall be defined by an interactive form dictionary
that shall be referenced from the AcroForm  entry in the document catalogue (see 7.7.2, “Document Catalog”). 
Table 218 shows the contents of this dictionary. 
Table 218 –  Entries in the interactive form dictionary  
Key
Type
Value
Fields
array
(Required) An array of references to the document’s root fields
(those with no ancestors in the field hierarchy). 
NeedAppearances
boolean
(Optional) A flag specifying whether to construct appearance 
streams and appearance dictionaries for all widget annotations 
in the document (see 12.7.3.3, “Variable Text”). Default value: 
false
SigFlags
integer
(Optional; PDF 1.3) A set of flags specifying various document-
level characteristics related to signature fields (see Table 219, 
and 12.7.4.5, “Signature Fields”). Default value: 0. 
CO
array
(Required if any fields in the document have additional-actions 
dictionaries containing a C entry; PDF 1.3) An array of indirect 
references to field dictionaries with calculation actions, defining 
the calculation order in which their values will be recalculated 
when  the  value  of  any  field  changes  (see  12.6.3,  “Trigger 
Events”). 
DR
dictionary
(Optional) A resource dictionary (see 7.8.3, “Resource 
Dictionaries”)  containing  default  resources  (such  as  fonts, 
patterns,  or  colour  spaces)  that  shall  be  used  by  form  field 
appearance streams. At a minimum, this dictionary shall contain 
Font entry specifying the resource name and font dictionary of 
the default font for displaying text. 
DA
string
(Optional) A d
ocument-wide default value for the DA attribute of 
variable text fields (see 12.7.3.3, “Variable Text”). 
Q
integer
(Optional) A document-wide default value for the Q attribute of 
variable text fields (see 12.7.3.3, “Variable Text”). 
XFA
stream or array
(Optional;  PDF  1.5) A stream or array containing an  XFA 
resource, whose format shall be described by the Data Package 
(XDP) Specification. (see the Bibliography). 
The value of this entry shall be either a stream representing the 
entire contents  of the XML Data Package or an  array  of  text 
string  and  stream  pairs  representing  the  individual  packets 
comprising the XML Data Package.
See 12.7.8, “XFA Forms,” for more information.
PDF 32000-1:2008
432
© 
Adobe Systems Incorporated 2008 – All rights reserved
The  value  of  the interactive  form  dictionary’s SigFlags entry  is  an  unsigned 32-bit integer  containing  flags 
specifying various document-level characteristics related to signature fields (see 12.7.4.5, “Signature Fields”). 
Bit positions within the flag word shall be numbered from 1 (low-order) to 32 (high-order). Table 219 shows the 
meanings of the flags; all undefined flag bits shall be reserved and shall be set to 0. 
12.7.3
Field Dictionaries
12.7.3.1
General
Each  field  in a document’s interactive  form  shall be  defined  by a field dictionary ,  which shall be an indirect 
object.  The  field  dictionaries  may  be  organized  hierarchically  into  one  or  more  tree  structures.  Many  field 
attributes are inheritable , meaning that if they are not explicitly specified for a given field, their values are taken 
from those  of its parent in  the field hierarchy.  Such inheritable  attributes  shall be designated as such in  the 
Tables 220 and 221. The designation (Required; inheritable) means that an attribute shall be defined for every 
field, whether explicitly in its own field dictionary or by inheritance from an ancestor in the hierarchy. Table 220
shows those entries that are common to all field dictionaries, regardless of type. Entries that pertain only to a 
particular type of field are described in the relevant sub-clauses in Table 220. 
Table 219 –  Signature flags  
Bit position
Name
Meaning
1
SignaturesExist
If set, the document contains at least one signature field. This flag 
allows a conforming reader to enable user interface items (such as 
menu items or pushbuttons) related to signature processing without 
having to scan the entire document for the presence of signature 
fields. 
2
AppendOnly
If set, the document contains signatures that may be invalidated if 
the file is saved (written) in a way that alters its previous contents, 
as opposed to an incremental update. Merely updating the file by 
appending new  information to the end  of the previous version is 
safe (see H.7, “Updating Example”). Conforming readers may use 
this flag to inform a user requesting a full save that signatures will 
be  invalidated and  require  explicit  confirmation before continuing 
with the operation. 
Table 220 –  Entries common to all field dictionaries  
Key
Type
Value
FT
name
(Required  for terminal  fields;  inheritable) The type of field that this 
dictionary describes: 
Btn 
Button (see 12.7.4.2, “Button Fields”) 
Tx 
Text (see 12.7.4.3, “Text Fields”) 
Ch 
Choice (see 12.7.4.4, “Choice Fields”) 
Sig
(PDF 1.3) Signature (see 12.7.4.5, “Signature Fields”) 
This  entry  may  be  present  in  a  non-terminal  field  (one  whose 
descendants are fields) to provide an inheritable FT value. However, a 
non-terminal field does not logically have a type of its own; it is merely 
a container for inheritable attributes that are intended for descendant 
terminal fields of any type. 
Parent
dictionary
(Required  if  this  field  is  the  child  of  another  in  the field  hierarchy; 
absent otherwise) The field that is the immediate parent of this one 
(the field, if any, whose Kids array includes this field). A field can have 
at most one parent; that is, it can be included in the Kids array of at 
most one other field. 
Documents you may be interested
Documents you may be interested