pdf viewer control in asp net c# : Add picture to pdf document control software platform web page windows azure web browser PDF32000_200844-part2363

© 
Adobe Systems Incorporated 2008 – All rights reserved
433
PDF 32000-1:2008
The  value of  the field dictionary’s Ff entry  is  an unsigned  32-bit  integer  containing  flags  specifying  various 
characteristics of the field. Bit positions within the flag word shall be numbered from 1 (low-order) to 32 (high-
order). The flags shown in Table 221 are common to all types of fields. Flags that apply only to specific field 
types are discussed in the sub-clauses describing those types. All undefined flag bits shall be reserved and 
shall be set to 0. 
Kids
array
(Sometimes  required,  as  described  below) An array of indirect 
references to the immediate children of this field. 
In a non-terminal field, the Kids array shall refer to field dictionaries 
that are immediate descendants of this field.  In a  terminal field, the 
Kids array ordinarily shall refer to one or more separate widget 
annotations that are associated with this field. However, if there is only 
one associated widget annotation, and its contents have been merged 
into the field dictionary, Kids shall be omitted.
T
text string
(Optional) The partial field name (see 12.7.3.2, “Field Names”). 
TU
text string 
(Optional; PDF 1.3) An alternate field name that shall be used in place 
of  the actual field name  wherever the field shall  be identified in the 
user interface (such as  in error or status  messages  referring to  the 
field). This text is also useful when extracting the document’s contents 
in  support  of  accessibility  to  users  with  disabilities  or  for  other 
purposes (see 14.9.3, “Alternate Descriptions”). 
TM
text string
(Optional;  PDF 1.3) The  mapping  name that shall be used when 
exporting interactive form field data from the document. 
Ff
integer
(Optional; inheritable) A set of flags specifying various characteristics 
of the field (see Table 221). Default value: 0. 
V
(various)
(Optional;  inheritable) The field’s value, whose format varies 
depending on  the  field type.  See the descriptions  of individual field 
types for further information. 
DV
(various)
(Optional; inheritable) The default value to which the field reverts when 
a reset-form action is executed (see 12.7.5.3, “Reset-Form Action”). 
The format of this value is the same as that of V
AA
dictionary
(Optional; PDF 1.2) An additional-actions dictionary defining the field’s 
behaviour in response to various trigger events (see 12.6.3, “Trigger 
Events”). This entry has exactly the same meaning as the AA entry in 
an annotation dictionary (see 12.5.2, “Annotation Dictionaries”). 
Table 221 –  Field flags common to all field types  
Bit position
Name
Meaning
1
ReadOnly
If set, the user may not change the value of the field. Any associated 
widget annotations will not interact with the user; that is, they will not 
respond to mouse clicks or change their appearance in response to 
mouse  motions.  This  flag  is  useful  for  fields  whose  values  are 
computed or imported from a database. 
2
Required
If set, the field shall have a value at the time it is exported by a submit-
form action (see 12.7.5.2, “Submit-Form Action”). 
3
NoExport
If  set,  the  field  shall  not  be  exported  by a  submit-form  action  (see 
12.7.5.2, “Submit-Form Action”). 
Table 220 –  Entries common to all field dictionaries  (continued)
Key
Type
Value
Add picture to pdf document - 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
how to add an image to a pdf; add signature image to pdf
Add picture to pdf document - 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 jpg to pdf; adding jpg to pdf
PDF 32000-1:2008
434
© 
Adobe Systems Incorporated 2008 – All rights reserved
12.7.3.2
Field Names
The T entry in the field dictionary (see Table 220) holds a text string defining the field’s partial field name. The 
fully qualified field name is not explicitly defined but shall be constructed from the partial field names of the field 
and all of its ancestors. For a field with no parent, the partial and fully qualified names are the same. For a field 
that is the child of another field, the fully qualified name shall be formed by appending the child field’s partial 
name to the parent’s fully qualified name, separated by a PERIOD (2Eh) as shown:
parent’s_full_name . child’s_partial_name
EXAMPLE
If a field with the partial field name PersonalData has a child whose partial name is Address, which in turn 
has a child with the partial name ZipCode, the fully qualified name of this last field is 
PersonalData . Address . ZipCode
Because  the  PERIOD  is  used  as  a  separator  for  fully  qualified  names, a  partial  name  shall  not  contain  a 
PERIOD character. Thus, all fields descended from a common ancestor share the ancestor’s fully qualified field 
name as a common prefix in their own fully qualified names. 
It is possible for different field dictionaries to have the same fully qualified field name if they are descendants of 
 common  ancestor  with  that  name  and  have  no  partial  field  names  (T  entries)  of  their  own.  Such  field 
dictionaries are different representations of the same underlying field; they should differ only in properties that 
specify their visual  appearance. In  particular,  field dictionaries with the same fully qualified field name  shall 
have the same field type (FT), value (V), and default value (DV). 
12.7.3.3
Variable Text
When the contents and properties of a field are known in advance, its visual appearance can be specified by an 
appearance  stream  defined  in  the  PDF  file  (see  12.5.5,  “Appearance  Streams,”  and  12.5.6.19,  “Widget 
Annotations”). In some cases, however, the field may contain text whose value is not known until viewing time. 
NOTE
Examples include text fields to be filled in with text typed by the user from the keyboard, scrollable list boxes 
whose  contents  are  determined interactively at  the  time the  document  is  displayed  and  fields  containing 
current dates or values calculated by a JavaScript.
In such cases, the PDF document cannot provide a  statically defined appearance stream for displaying  the 
field. Instead, the conforming reader shall construct an appearance stream dynamically at viewing time. The 
dictionary  entries shown in Table 222 provide  general  information about the field’s  appearance  that can be 
combined with the specific text it contains to construct an appearance stream. 
Table 222 –  Additional entries common to all fields containing variable text  
Key
Type
Value
DA
string
(Required; inheritable) The default appearance string containing a sequence of 
valid page-content graphics or text state operators that define such properties 
as the field’s text size and colour. 
Q
integer
(Optional; inheritable) A code specifying the form of quadding (justification) that 
shall be used in displaying the text: 
 Left-justified 
 Centered 
 Right-justified 
Default value: 0 (left-justified). 
DS
text string
(Optional; PDF 1.5) A default style string, as described in 12.7.3.4, “Rich Text 
Strings.”
C# TIFF: How to Insert & Burn Picture/Image into TIFF Document
Support adding image or picture to an existing new REImage(@"c:\ logo.png"); // add the image powerful & profession imaging controls, PDF document, tiff files
add picture to pdf form; add photo to pdf reader
VB.NET TIFF: How to Draw Picture & Write Text on TIFF Document in
Dim drawing As RaterEdgeDrawing = New RaterEdgeDrawing() drawing.Picture = "RasterEdge" drawing powerful & profession imaging controls, PDF document, tiff files
adding images to a pdf document; add picture to pdf online
© 
Adobe Systems Incorporated 2008 – All rights reserved
435
PDF 32000-1:2008
The  new  appearance stream becomes  the  normal  appearance (N) in the  appearance dictionary  associated 
with the field’s widget annotation (see Table 168). (If the widget annotation has no appearance dictionary, the 
conforming reader shall create one and store it in the annotation dictionary’s AP entry.)
In  PDF  1.5,  form  fields  that  have  the  RichText  flag  set  (see  Table 226)  specify  formatting  information  as 
described in 12.7.3.4,  “Rich  Text  Strings.” For these fields,  the following  conventions are  not  used,  and the 
entire annotation appearance shall be regenerated each time the value is changed. 
For non-rich text fields, the appearance stream—which, like all appearance streams, is a form XObject—has 
the contents of its form dictionary initialized as follows: 
The  resource  dictionary  (Resources)  shall  be  created  using  resources  from  the  interactive  form 
dictionary’s DR entry (see Table 218).
The lower-left corner of the bounding box (BBox) is set to coordinates (0, 0) in the form coordinate system. 
The box’s top and right coordinates are taken from the dimensions of the annotation rectangle (the Rect
entry in the widget annotation dictionary). 
All other entries in the appearance stream’s form dictionary are set to their default values (see 8.10, “Form 
XObjects”). 
EXAMPLE
The appearance stream includes the following section of marked content, which represents the portion of 
the stream that draws the text: 
/Tx  BMC
% Begin marked content with tag Tx 
q
% Save graphics state
… Any required graphics state changes, such as clipping …
BT
% Begin text object
… Default appearance string ( DA ) …
… Text-positioning and text-showing operators to show the variable text …
ET
% End text object
Q
% Restore graphics state
EMC
% End marked content
The BMC (begin marked  content)  and EMC  (end  marked content) operators  are  discussed  in  14.6, 
“Marked  Content.” q  (save  graphics  state)  and Q  (restore  graphics  state)  are  discussed  in  8.4.4, 
“Graphics State Operators.” BT (begin text object) and ET (end text object) are discussed in 9.4, “Text 
Objects.” See Example 1 in 12.7.8, “XFA Forms” for an example.
The default appearance string (DA) contains any graphics state or text state operators needed to establish the 
graphics state parameters, such as text size and colour, for displaying the field’s variable text. Only operators 
that are  allowed  within  text  objects shall occur  in  this  string (see  Figure  9). At  a minimum,  the  string shall 
include a Tf (text font) operator along with its two operands, font and size. The specified font value shall match 
a resource  name  in  the Font  entry of  the  default resource  dictionary (referenced from the DR entry of  the 
interactive form dictionary; see Table 218). A zero value for size means that the font shall be auto-sized: its size 
shall be computed as a function of the height of the annotation rectangle. 
The default appearance string shall contain at most one Tm  (text matrix) operator. If this operator is present, 
the conforming reader shall replace the horizontal and vertical translation components with positioning values it 
determines  to  be  appropriate, based  on  the field  value,  the quadding  (Q)  attribute,  and  any  layout  rules  it 
employs.  If  the  default  appearance  string  contains  no Tm   operator,  the  viewer  shall  insert  one  in  the 
appearance  stream  (with  appropriate  horizontal  and  vertical  translation  components)  after  the  default 
appearance string and before the text-positioning and text-showing operators for the variable text.
RV
text string 
or text 
stream
(Optional;  PDF  1.5) A rich text string, as described in 12.7.3.4, “Rich Text 
Strings.”
Table 222 –  Additional entries common to all fields containing variable text  (continued)
Key
Type
Value
C# Word - Paragraph Processing in C#.NET
Add references: CreateParagraph(); //Create a picture for para IPicture picture = para.CreatePicture(imageSrcPath); //Save the document doc0.Save
how to add image to pdf acrobat; adding image to pdf form
VB.NET Image: Create Code 11 Barcode on Picture & Document Using
file, apart from above mentioned .NET core imaging SDK and .NET barcode creator add-on, you also need to buy .NET PDF document editor add-on, namely, RasterEdge
add jpg to pdf form; add jpg to pdf acrobat
PDF 32000-1:2008
436
© 
Adobe Systems Incorporated 2008 – All rights reserved
To update an existing appearance stream to reflect a new field value, the conforming reader shall first copy any 
needed resources from the document’s DR dictionary (see Table 218) into the stream’s Resources dictionary. 
(If  the DR  and Resources  dictionaries  contain  resources  with  the  same  name,  the  one  already  in  the 
Resources dictionary shall be left intact, not replaced with the corresponding value from the DR dictionary.) 
The conforming reader shall then replace the existing contents of the appearance stream from /Tx  BMC to the 
matching EMC with the corresponding new contents as shown in Example 1 in "Check Boxes," 12.7.4, “Field 
Types.” (If the existing appearance stream contains no marked content with tag Tx, the new contents shall be 
appended to the end of the original stream.) 
12.7.3.4
Rich Text Strings
Beginning  with  PDF 1.5,  the text contents  of  variable  text  form  fields, as  well as markup annotations,  may 
include formatting (style) information. These rich text strings  are fully-formed XML documents that conform to 
the rich text conventions specified for the XML Forms Architecture (XFA) specification, which is itself a subset 
of the XHTML 1.0 specification, augmented with a restricted set of CSS2 style attributes (see the Bibliography
for references to all these standards). 
Table 223  lists  the  XHTML  elements  that  may  appear  in  rich  text  strings.  The  <body>  element  is  the  root 
element; its required attributes are listed in Table 224. Other elements (<p> and <span>) contain enclosed text 
that may take style attributes, which are listed in Table 225. These style attributes are CSS inline style property 
declarations of the form name:value, with each declaration separated by a SEMICOLON (3Bh), as illustrated in 
the Example in "Radio Buttons," 12.7.4, “Field Types.” 
In PDF 1.6, PDF supports the rich text elements and attributes specified in the XML Forms Architecture (XFA) 
Specification, 2.2 (see Bibliography). These rich text elements and attributes are a superset of those described 
in Table 223, Table 224 and Table 225. In PDF 1.7, PDF supports the rich text elements and attributes specified 
in the XML Forms Architecture (XFA) Specification, 2.4 (see Bibliography). 
Table 223 –  XHTML elements used in rich text strings  
element
Description
<body>
The element at the root of the XML document. Table 224 lists the required attributes for 
this element.
<p>
Encloses text that shall be interpreted as a paragraph. It may take the style attributes 
listed in Table 225.
<i>
Encloses text that shall be displayed in an italic font.
<b>
Encloses text that shall be displayed in a bold font.
<span>
Groups text solely for the purpose of applying styles (using the attributes in Table 225).
Table 224 –  Attributes of the <body> element  
Attribute
Description
xmlns
The  default  namespaces  for  elements  within  the  rich  text  string.  Shall  be 
xmlns="http://www.w3.org/1999/xhtml" 
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0". 
xfa:contentType
Shall be "text/html".
VB.NET PowerPoint: Add Image to PowerPoint Document Slide/Page
clip art or screenshot, the picture will be AddPage", "InsertPage" and "DeletePage" to add, insert or & profession imaging controls, PDF document, tiff files
adding image to pdf file; add signature image to pdf acrobat
VB.NET Image: VB.NET Planet Barcode Generator for Image, Picture &
on Overview. VB.NET Planet Barcode Creator Add-on within Generate Planet Barcode on Picture & Image in VB.NET. In for adding Planet barcode image to PDF, TIFF or
add image pdf document; adding an image to a pdf
© 
Adobe Systems Incorporated 2008 – All rights reserved
437
PDF 32000-1:2008
xfa:APIVersion
A string that identifies the software used to generate the rich text string. It shall be of 
the form software_name:software_version, where
software_name identifies the software by name. It shall not contain spaces.
software_version identifies  the  version  of the software. It consists of  a series of 
integers separated by decimal points. Each integer is a version number, the leftmost 
value being  a  major  version number, with values to the right  increasingly minor. 
When comparing strings, the versions shall be compared in order. 
NOTE
“5.2” is less than “5.13”  because 2  is less than 13; the string is not 
treated as a decimal number. When comparing strings with different 
numbers of sections, the string with fewer sections is implicitly padded 
on  the  right  with  sections  containing  “0”  to  make  the  number  of 
sections equivalent.
xfa:spec
The version of the XML Forms Architecture (XFA) specification to which the rich text 
string complies. If the file being written conforms to PDF 1.5, then the rich text string 
shall conform to XFA 2.0, and this attribute shall be XFA 2.0; if the file being written 
conforms to PDF 1.6, then the rich text string shall conform to XFA 2.2, and this 
attribute shall be XFA 2.2; and if the file being written conforms to PDF 1.7, then the 
rich text string shall conform to XFA 2.4, and this attribute shall be XFA 2.4.
Table 225 –  CSS2 style attributes used in rich text strings  
Attribute
Value
Description
text-align
keyword
Horizontal alignment. Possible values: left, right, and center.
vertical-align
decimal
An amount by which to adjust the baseline of the enclosed  text. A 
positive value indicates a superscript;  a negative  value indicates  a 
subscript.  The value is of  the form <decimal number> pt,  optionally 
preceded by a sign, and followed by “pt”. 
EXAMPLE
-3pt, 4pt. 
font-size
decimal
The font size of the enclosed text. The value is of the form
<decimal number>pt.
font-style
keyword
Specifies the font style of the enclosed text. Possible values: normal, 
italic.
font-weight
keyword
The weight of the font for the enclosed text. Possible values: normal, 
bold, 100, 200, 300, 400, 500, 600, 700, 800, 900.
normal is equivalent to 400, and bold is equivalent to 700.
font-family
list
A font name  or list of font  names  that shall be used to display the 
enclosed text. (If a list is provided, the first one containing glyphs for 
the specified text shall be used.)
font
list
A shorthand CSS font property of the form
font:<font-style> <font-weight> <font-size> <font-family>
color
RGB 
value
The colour of the enclosed text. It can be in one of two forms:
#rrggbb with a 2-digit hexadecimal value for each component
rgb(rrr,ggg,bbb) with a decimal value for each component.
Although the values specified by the color property are interpreted as 
sRGB  values,  they  shall  be  transformed  into  values  in  a  non-ICC 
based  colour  space  when  used  to  generate  the  annotation’s 
appearance.
Table 224 –  Attributes of the <body> element  (continued)
Attribute
Description
VB.NET Image: Image Cropping SDK to Cut Out Image, Picture and
SDK; VB.NET image cropping method to crop picture / photo; VB.NET image cropping control add-on needs a PC com is professional provider of document, content and
add photo to pdf for; adding image to pdf in preview
VB.NET Image: Image Scaling SDK to Scale Picture / Photo
this VB.NET image scaling control add-on, we API, developer can only scale one image / picture / photo at com is professional provider of document, content and
attach image to pdf form; add image to pdf in preview
PDF 32000-1:2008
438
© 
Adobe Systems Incorporated 2008 – All rights reserved
Rich text strings shall be specified by the RV entry of variable text form field dictionaries (see Table 222) and 
the RC entry of markup  annotation dictionaries  (see Table 170). Rich text strings may be packaged as text 
streams (see 7.9.3, “Text Streams”). Form fields using rich text streams should also have the RichText flag set 
(see Table 228).
default style string shall be specified by the DS entry for free text annotations (see Table 174) or variable text 
form fields (see Table 222). This string specifies the default values for style attributes, which shall be used for 
any style attributes that are not explicitly specified for the annotation or field. All attributes listed in Table 225
are legal in the default style string. This string, in addition to the RV or RC entry, shall be used to generate the 
appearance.
NOTE 1
Markup annotations other than free text annotations (see 12.5.6.2, “Markup Annotations”) do not use a default 
style string because their appearances are implemented using  platform  controls  requiring the  conforming 
reader to pick an appropriate system font for display.
When a form field or annotation contains rich text strings, the flat text (character data) of the string should also 
be preserved (in the V entry for form fields and the Contents entry for annotations). This enables older readers 
to read and edit the data (although with loss of formatting information). The DA entry should be written out as 
well when the file is saved.
When  a  rich  text  string  specifies  font  attributes,  the  conforming  reader  shall  use  font  name  selection  as 
described in Section 15.3 of the CSS2 specification (see the Bibliography). Precedence should be given to the 
fonts in the default resources dictionary, as specified by the DR entry in Table 218.
EXAMPLE
The following example illustrates the entries in a widget annotation dictionary for rich text. The DS entry 
specifies the default font. The RV entry contains two paragraphs of rich text: the first paragraph specifies 
bold and italic text in the default font; the second paragraph changes the font size.
/DS (font: 18pt Arial)
% Default style stri
ng using an abbreviated font
% descriptor to specify 18pt text using an Arial font
/RV (<?xml version="1.0"?><body xmln
s="http://www.w3.org/1999/xtml"
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/" 
xfa:contentType="text/html" xfa:APIVersion="Acrobat:8.0.0" xfa:spec="2.4">
<p style="text-align:left">
<b>
<i>
Here is some bold italic text
</i>
</b>
</p>
<p style= "font-size:16pt">
This text uses default text state parame
ters but changes the font size to 16.
</p>
</body> )
text-decoration
keyword
One of the following keywords:
underline: The enclosed text shall be underlined.
line-through: The enclosed text shall have a line drawn through it.
font-stretch
keyword
Specifies a normal, condensed or extended face from a font family. 
Supported  values  from  narrowest  to  widest  are  ultra-condensed, 
extra-condensed,  condensed,  semi-condensed,  normal,  semi-
expanded, expanded, extra-expanded, and ultra-expanded.
Table 225 –  CSS2 style attributes used in rich text strings  (continued)
Attribute
Value
Description
© 
Adobe Systems Incorporated 2008 – All rights reserved
439
PDF 32000-1:2008
12.7.4
Field Types
12.7.4.1
General
Interactive forms support the following field types:
Button fields represent interactive controls on the screen that the user can manipulate with the mouse. 
They include pushbuttonscheck boxes, and radio buttons . 
Text fields are boxes or spaces in which the user can enter text from the keyboard. 
Choice fields contain several text items, at most one of which may be selected as the field value. They 
include scrollable list boxes  and combo boxes. 
Signature fields represent digital signatures and optional data for authenticating the name of the signer and 
the document’s contents.
The following sub-clauses describe each of these field types in detail. Further types may be added in the future. 
12.7.4.2
Button Fields
12.7.4.2.1
General
button field (field type Btn) represents an interactive control on the screen that the user can manipulate with 
the mouse. There are three types of button fields: 
pushbutton is a  purely interactive control  that  responds  immediately to  user input without retaining a 
permanent value (see 12.7.4.2.2, “Pushbuttons”). 
check box toggles between two states, on and off (see 12.7.4.2.3, “Check Boxes”). 
Radio button fields contain a set of related buttons that can each be on or off. Typically, at most one radio 
button in a set may be on at any given time, and selecting any one of the buttons automatically deselects 
all the others. (There are exceptions to this rule, as noted in "Radio Buttons.") 
For button fields, bits 15, 16, 17, and 26 shall indicate the intended behaviour of the button field. A conforming 
reader  shall  follow  the  intended  behaviour,  as  defined  in  Table 226 and  clauses 12.7.4.2.2,  "Pushbuttons", 
12.7.4.2.3, "Check Boxes" and 12.7.4.2.4, "Radio Buttons".
Table 226 –  Field flags specific to button fields  
Bit position
Name
Meaning
15
NoToggleToOff
(Radio  buttons  only) If set, exactly one radio button shall be 
selected at all times; selecting the currently selected button has no 
effect. If clear, clicking the selected button deselects it, leaving no 
button selected. 
16
Radio
If set, the field is a set of radio buttons; if clear, the field is a check 
box. This flag may be set only if the Pushbutton flag is clear. 
17
Pushbutton
If set, the field is a pushbutton that does not retain a permanent 
value. 
26
RadiosInUnison
(PDF 1.5) If set, a group of radio buttons within a radio button field 
that  use  the same value  for the on  state  will turn  on  and off  in 
unison; that is if one is checked, they are all checked. If clear, the 
buttons are mutually exclusive (the same behavior as HTML radio 
buttons).
PDF 32000-1:2008
440
© 
Adobe Systems Incorporated 2008 – All rights reserved
12.7.4.2.2
Pushbuttons
pushbutton field shall have a field type of Btn and the Pushbutton flag (see Table 226) set to one. Because 
this type of button retains no permanent value, it shall not use the V and DV entries in the field dictionary (see 
Table 220). 
12.7.4.2.3
Check Boxes
check box field represents  one  or  more  check  boxes  that  toggle  between  two  states,  on  and  off,  when 
manipulated by the user with the mouse or keyboard. Its field type shall be Btn and its Pushbutton and Radio 
flags (see Table 226) shall both be clear. Each state can have a separate appearance, which shall be defined 
by  an  appearance  stream  in  the  appearance  dictionary  of  the  field’s  widget  annotation  (see  12.5.5, 
“Appearance  Streams”).  The  appearance  for  the  off  state  is  optional  but,  if  present,  shall  be  stored  in  the 
appearance dictionary under the name OffYes should be used as the name for the on state.
The V  entry  in  the  field  dictionary  (see  Table 220)  holds  a  name  object  representing  the  check  box’s 
appearance state, which shall be used to select the appropriate appearance from the appearance dictionary. 
EXAMPLE 1
This example shows a typical check box definition. 
1 0 obj
<<  /FT  /Btn
/T  ( Urgent )
/V  /Yes
/AS  /Yes
/AP  <<  /N  <<  /Yes  2 0 R /Off   3 0 R>>
>>
endobj
2 0 obj
<<  /Resources  20 0 R
/Length  104
>>
stream
q
 0  1  rg
BT
/ZaDb  12  Tf
 0  Td
( 8 )  Tj
ET
Q
endstream
endobj
3 0 obj
<<  /Resources  20 0 R
/Length  104
>>
stream
q
 0  1  rg
BT
/ZaDb  12  Tf
 0  Td
( 8 )  Tj
ET
Q
endstream
endobj
© 
Adobe Systems Incorporated 2008 – All rights reserved
441
PDF 32000-1:2008
Beginning with PDF 1.4, the field dictionary for check boxes and radio buttons may contain an optional Opt
entry (see Table 227). If present, the Opt entry shall be an array of text strings representing the export value of 
each annotation in the field. It may be used for the following purposes:
To represent the export values of check box and radio button fields in non-Latin writing systems. Because 
name objects in the appearance dictionary are limited to PDFDocEncoding, they cannot represent non-
Latin text. 
To allow radio buttons or check boxes to be checked independently, even if they have the same export 
value.
EXAMPLE 2
A group of check boxes may be duplicated on more than one page such that the desired behavior is that 
when a user checks a box, the corresponding boxes on each of the other pages are also checked. In this 
case, each of the corresponding check boxes is a widget in the Kids array of a check box field. 
NOTE
For radio buttons, the same behavior shall occur only if the RadiosInUnison flag is set. If it is not set, at most 
one radio button in a field shall be set at a time. 
12.7.4.2.4
Radio Buttons
A radio button field is a set of related buttons. Like check boxes, individual radio buttons have two states, on 
and off. A single radio button may not be turned off directly but only as a result of another button being turned 
on. Typically, a set of radio buttons (annotations that are children of a single radio button field) have at most one 
button in the on state at any given time; selecting any of the buttons automatically deselects all the others. 
NOTE
An exception occurs when multiple radio buttons in a field have the same on state and the RadiosInUnison flag 
is set. In that case, turning on one of the buttons turns on all of them.
The field type is Btn, the Pushbutton flag (see Table 226) is clear, and the Radio flag is set. This type of button 
field has an additional flag, NoToggleToOff, which specifies, if set, that exactly one of the radio buttons shall be 
selected at all times. In this case, clicking the currently selected button has no effect; if the NoToggleToOff flag 
is clear, clicking the selected button deselects it, leaving no button selected. 
The Kids entry in the radio button field’s field dictionary (see Table 220) holds an array of widget annotations 
representing the individual buttons in the set. The parent field’s V entry holds a name object corresponding to 
the appearance state of whichever child field is currently in the on state; the default value for this entry is Off. 
EXAMPLE
This example shows the object definitions for a set of radio buttons. 
10  0  obj
% Radio button field
<<  /FT  /Btn
/Ff  …
% … Radio flag = 1, Pushbutton = 0 …
/T  ( Credit card )
/V  /cardbrand1
/Kids [  11 0 R
 12 0 R
]
Table 227 –  Additional entry specific to check box and radio button fields  
Key
Type
Value
Opt
array of text 
strings
(Optional; inheritable;  PDF 1.4) An array containing one entry for each widget 
annotation in the Kids array of the radio button or check box field. Each entry 
shall  be  a  text  string  representing  the  on  state  of  the  corresponding  widget 
annotation.
When this entry is present, the names used to represent the on state in the AP
dictionary of each annotation (for example, /1, /2) numerical position (starting with 
0) of the annotation in the Kids array, encoded as a name object. This allows 
distinguishing  between the annotations even  if two or more of  them  have the 
same value in the Opt array.
PDF 32000-1:2008
442
© 
Adobe Systems Incorporated 2008 – All rights reserved
>>
endobj
11  0  obj
% First radio button
<<  /Parent  10 0 R
/AS  /cardbrand1
/AP  <<  /N
<<  /cardbrand1  8 0 R
/Off  9 0 R
>>
 >>
>>
endobj
12  0  obj
% Second radio button
<<  /Parent  10 0 R
/AS  /Off
/AP  <<  /N
<<  /cardbrand2  8 0 R
/Off  9 0 R
>>
 >>
>>
endobj
 0  obj
% Appearance stream for “on” state
<<  /Resources  20 0 R
/Length  104
>>
stream
q
 0  1  rg
BT
/ZaDb  12  Tf
 0  Td
( 8 )  Tj
ET
Q
endstream
endobj
 0  obj
% Appearance stream for “off” state
<<  /Resources  20 0 R
/Length  104
>>
stream
q
 0  1  rg
BT
/ZaDb  12  Tf
 0  Td
( 4 )  Tj
ET
Q
endstream
endobj
Like a check box field, a radio button field may use the optional Opt entry in the field dictionary (PDF 1.4) to 
define  export  values  for  its  constituent  radio  buttons,  using  Unicode  (UTF-16BE)  encoding  for  non-Latin 
characters (see Table 227). 
12.7.4.3
Text Fields
text field  (field type Tx) is a box or space for text fill-in data typically entered from a keyboard. The text may 
be restricted to a single line or may be permitted to span multiple lines, depending on the setting of the Multiline 
Documents you may be interested
Documents you may be interested