AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Background     161
If specified as a sibling to a Metadata
source element, the Metadata
source is imported first and the 
value of Author overrides the imported metadata. 
Category
“Document properties” on page146
Attributes
Background
Provides styled text or PDF content for placement behind the existing page content. 
<Background
alternation
="Noneor "OddPages" or "EvenPages"
fitToPage
="true" or "false"
horizontalAnchor
="Left" or "Center" or "Right"
horizontalOffset
="0ptor "length"
opacity
="100%or "percentage"
rotation
="0or "xs:integer"
scale
="100%or "percentage"
showOnScreen
="trueor "false"
showWhenPrinting
="trueor "false"
verticalAnchor
="Top" or "Middle" or "Bottom"
verticalOffset
="0ptor "length"
replaceExisting
="trueor "false"
>
<StyledText
or < PDF
source> [1] 
<TargetLocale
[0..1]
</Background>
Can be contained in the elements PDF
result, PDF
source, PDFGroup
TableOfContents
PackageFiles
filter, select, or conversion elements, TableOfContentsPagePattern
BlankPage
and StyleProfile
.
The Background element applies a background to all pages in the scope of its parent element. If 
replaceExisting is omitted or is "true", then this element replaces any pre-existing backgrounds on 
those pages. In LiveCycleES 8.0 and later, the replaceExisting
attribute lets you retain pre-existing 
backgrounds when adding one new background. If replaceExisting is "false", a new Background 
is added to the existing Background. Each page can contain at most one background. Transient results 
allow for the addition of multiple backgrounds.
If the background content is provided in a PDF
source element, the first page from the source document is 
used for the background.
Use the Watermark
element to place content over the existing page content.
Name
Description
value
Required. Specifies the author name. Any value, including an empty string, overrides 
the author name in the resultant document. The string value can be specified with 
an External Data URL. (See “External Data URL” on page152
.)
Convert pdf file to text document - Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
convert scanned pdf to text online; convert pdf file to text
Convert pdf file to text document - VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
convert pdf to txt format; convert pdf scanned image to text
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Background     162
Category
“Page content” on page148
Attributes
Name
Description
alternation
Optional. Specifies whether the element’s settings apply to all pages or to 
alternating pages. This attribute can have the following values:
None (default) - Settings apply to all pages.
OddPages - Settings apply to odd pages only.
EvenPages - Settings apply to even pages only.
Pages are considered odd or even depending on their ordinal page number 
in the resultant document.
fitToPage
Optional. Specifies whether to scale the background content to fit the page. 
This attribute can have the following values:
false (default) - Background content is scaled according to the scale
attribute.
true - Background content is forced to fit the boundaries of the page size, 
by either expanding or shrinking the text. The scale
attribute is ignored.
horizontalAnchor
Optional. Specifies a horizontal anchor point, relative to the PageMargins
element of the page on which the background is placed. The 
horizontalOffset
attribute lets you modify the placement relative to this 
anchor. This attribute can have the following values:
Left - Left page margin 
Center (default) - Midpoint between the left and right margins
Right - Right margin 
horizontalOffset
Optional. Offset from the horizontal anchor point specified in the 
horizontalAnchor
attribute. A positive value moves the background 
right, while a negative value moves it left. 
opacity
Optional. Transparency of the background. The value can be a decimal in the 
range of .0 to 1.0 or a percentage in the range of 0% to 100%. In the latter 
case, the percentage sign (%) is required.
replaceExisting
Optional. If set to false, the specified background does not replace any 
pre-existing background.
rotation
Optional. Rotation of the background upon the page. The valid range is -360 
to 360°. 
scale
Optional. Scaling of the background. The valid range is 8% to 3200%. The 
value can be a decimal in the range of .0 to 1.0 or a percentage in the range of 
0% to 100%. In the latter case, the percentage sign (%) is required.
C# PDF Text Extract Library: extract text content from PDF file in
XDoc.PDF for .NET offers advanced & mature APIs for developers to extract text content from PDF document file in C#.NET class application.
convert scanned pdf to text word; c# read text from pdf
VB.NET PDF Text Extract Library: extract text content from PDF
this advanced PDF Add-On, developers are able to extract target text content from source PDF document and save extracted text to other file formats through VB
pdf to text converter; convert pdf to rich text format
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
BlankPage     163
BlankPage
Specifies the addition of an initially blank page to the document.
<BlankPage
forceEven
="true" or "false"
>
<ArtBox
[0..2, where 2 is allowed for alternating pages]
<Background
or 
<NoBackgrounds
[0..2, where 2 is allowed for alternating pages]
<BleedBox
[0..2, where 2 is allowed for alternating pages]
<Footer
or <NoFooters
[0..2, where 2 is allowed for alternating pages]
<Header
or <NoHeaders
[0..2, where 2 is allowed for alternating pages]
<PageContent
[0..n]
<PageLabel
[0..1]
<PageMargins
[0..2, where 2 is allowed for alternating pages]
<PageOverlay
[0..n]
<PageRotation
[0..1]
<PageSize
[0..1]
<PageUnderlay
[0..n]
<TargetLocale
[0..1]
<TrimBox
[0..2, where 2 is allowed for alternating pages]
<Watermark
showOnScreen
Optional. Controls whether the background is displayed when pages are 
viewed with an application such as Acrobat. This attribute can have the 
following values:
true (default) - The background is displayed.
false - The background is not displayed.
showWhenPrinting
Optional. Controls whether the background is included when pages are 
printed with an application such as Acrobat. This attribute can have the 
following values: 
true (default) - The background is included.
false - The background is not included.
verticalAnchor
Optional. Specifies a vertical anchor point, relative to the PageMargins
element of the page on which the background is placed. The 
verticalOffset
attribute lets you modify the placement relative to this 
anchor. This attribute can have the following values:
Top - Top page margin 
Middle (default) - Midpoint between the top and bottom margins. 
Bottom - Bottom margin 
verticalOffset
Optional. Offset from the vertical anchor point specified in the 
verticalAnchor
attribute. A positive value moves the background up, 
while a negative value moves it down. 
Name
Description
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
All object data. File attachment. Hidden layer content. Convert smooth lines to curves. VB.NET Demo Code to Optimize An Exist PDF File in Visual C#.NET Project.
convert image pdf to text pdf; converting pdf to plain text
C# PDF File Split Library: Split, seperate PDF into multiple files
Visual C# .NET PDF document splitter control toolkit SDK can not only offer C# developers a professional .NET solution to split PDF document file but also
change pdf to txt file; convert pdf to openoffice text
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
BleedBox     164
or <NoWatermarks
[0..2, where 2 is allowed for alternating pages]
</BlankPage>
Can be contained in the elements PDF
result and PDFGroup
Note:The PageContent element adds only its content, not the value of its alternateText attribute. 
This limitation is because pages added via the BlankPage  element are not tagged.
This element causes the Assembler service to append a blank page to the assembled document in the 
following situations:
forceEven="false" 
forceEven="true" and there is an odd number of pages in the resultant document at the point 
where the BlankPage element appears.
Pages added by the BlankPage element inherit page properties and content specified for parent 
elements, as well as the page properties specified as children of BlankPage. If PageSize and 
PageRotation are not specified within the scope of the BlankPage element, their values are taken 
from the result PDF page just before the blank page. If there is no preceding page, their values are taken 
from the following page. 
Similarly, if a page label is not specified within the scope of the blank page, the following results occurs:
If there are no other page labels in the document, the blank page has no page labels.
If there are page labels in the document, the blank page takes its labeling style from the previous page 
in the assembly. This same behavior also occurs when <PageLabel mode="Continue"/> is 
specified. If no pages precede the blank page, it takes a filler label that is equal to the ordinal page 
number.
Category
“Document assembly” on page143
Attributes
BleedBox
Defines the bounds to which the contents of the page are clipped when output in a production 
environment. 
<BleedBox
left="0ptor "length"
top="0ptor "length"
right="0pt" or "length"
bottom="0ptor "length"
alternation="Noneor "OddPages" or "EvenPages"
Name
Description
forceEven
Optional. Specifies the conditions when a blank page is added. (See description 
for the BlankPage
element.) This attribute can have the following values:
false (default) - A blank page is always added. 
true - A blank page is added only if there is an odd number of pages in the 
resultant document up to that point.
C# PDF File Compress Library: Compress reduce PDF size in C#.net
All object data. File attachment. Hidden layer content. Convert smooth lines to curves. Flatten visible layers. C#.NET DLLs: Compress PDF Document.
convert pdf to text without losing formatting; converting pdf to searchable text format
VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
VB.NET Demo code to Append PDF Document. In addition, VB.NET users can append a PDF file to the end of a current PDF document and combine to a single PDF file.
convert pdf to text file; c# pdf to txt
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Bookmarks     165
/>
Can be contained in the elements PDF
result, PDF
source, PDFGroup
TableOfContents
TableOfContentsPagePattern
PackageFiles
filter, select, or conversion elements, and 
BlankPage
This element is intended for use by prepress professionals only. 
Category
“Page properties” on page147
Attributes
Bookmarks 
Bookmarks elements enable the bookmarks contained in PDF documents to be exported, imported, and 
removed. Bookmarks elements can have the following varieties:
Bookmarks
result. Specifies an XML document containing bookmarks from its child elements.
Bookmarks
source. Specifies bookmarks contained in a Bookmarks XML document. The bookmarks 
are imported into all pages within the scope of the parent element.
Bookmarks
filter. Specifies the bookmarks from its child elements, which can be imported into all 
pages within the scope of the parent element. 
Also see the NoBookmarks
element, which specifies that bookmarks be removed from all pages within 
the scope of the parent element.
In PDF documents, bookmarks are a tree-structured hierarchy of outline items that provide a means of 
navigating the document. When a user in a viewer application clicks a bookmark, an action is triggered. 
Name
Description
left
Optional. Width of the margin as measured from the left side of the page to the 
left side of the bleed box. In this case, the page is the visible page as viewed in 
Acrobat. 
top
Optional. Width of the margin as measured from the top of the page to the top 
of the bleed box. In this case, the page is the visible page as viewed in Acrobat. 
right
Optional. Width of the margin as measured from the right side of the page to the 
right side of the bleed box. In this case, the page is the visible page as viewed in 
Acrobat. 
bottom
Optional. Width of the margin as measured from the bottom of the page to the 
bottom of the bleed box. In this case, the page is the visible page as viewed in 
Acrobat. 
alternation
Optional. Specifies whether the margin settings apply to all pages or alternating 
pages. This attribute can have the following values:
None (default) - The margin settings apply to all pages. 
OddPages - The margin settings apply to odd pages only.
EvenPages - The margin settings apply to even pages only.
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Separate source PDF document file by defined page range in VB.NET class application. Divide PDF file into multiple files by outputting PDF file size.
convert pdf to text online no email; batch convert pdf to text
C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
document file, and choose to create a new PDF file in .NET deleting, PDF document splitting, PDF page reordering and PDF page image and text extraction.
convert pdf images to text; convert pdf to plain text online
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Bookmarks result     166
Typically, a bookmark action specifies a particular location in the document to which the viewer should 
navigate. However, bookmarks can also trigger actions such as opening web pages or running JavaScript 
code.
Bookmarks result
Specifies that bookmarks from the child elements be exported to an XML document.
<Bookmarks 
result
="xs:string"
return
="trueor "false"
>
PDF
source> and/or <PDFGroup
[1..n] 
<Bookmarks
source[0..n]
<Bookmarks
filter[0..n]
<TargetLocale
[0..1]
</Bookmarks>
Can be contained in the DDX
element, which is the DDX root.
This element directs the Assembler service to export the bookmarks in the element’s child elements. If the 
Bookmarks result element contains multiple PDF
source documents, they are effectively assembled into 
a single PDF document from which bookmarks are exported. (This document is not returned to the user.)
Bookmarks are exported in an XML document that conforms to the Bookmarks XML language, which is a 
component of the XPDF language. (See “Bookmarks Language” on page321
.)
This element must contain at least one PDF
source element, either as a direct child or within a child 
PDFGroup
element. 
Category
“Document components” on page144
Attributes
Bookmarks source
Bookmarks contained in an XML document are imported into all pages within the scope of the parent 
element. 
Name
Description
result
Required. Specifies a name to be associated with the exported bookmarks. This 
name must be unique among all result elements in the DDX document. This name 
can be specified with an External Data URL. (See “External Data URL” on page152
.)
return
Optional. Specifies whether the exported bookmarks are returned to the client. This 
attribute can have the following values:
true (default) - Exported bookmarks are returned to the client.
false - Exported bookmarks are transient data, which can be referenced as the 
source from a subsequent result element. The bookmarks are not returned to the 
client.
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Bookmarks filter     167
<Bookmarks 
source
="xs:string" 
/>
Can be contained in the elements PDF
result,  PDF
source, PackageFiles
filter, select, or conversion 
elements, and PDFGroup
This element identifies an XML document representing PDF bookmarks. The bookmarks are aggregated 
with bookmarks in other sibling source elements, if any. The aggregation replaces any bookmarks found in 
any pages within the scope of the parent element. 
Category
“Document components” on page144
Attributes
Bookmarks filter 
Specifies that bookmarks from child source elements be imported into the pages within the scope of the 
parent element. 
<Bookmarks>
PDF
source> and/or <PDFGroup
[1..n] 
<Bookmarks
source[0..n] 
<TargetLocale
[0..1]
</Bookmarks>
Can be contained in the elements PDF
result, PDF
source, PackageFiles
filter, select, or conversion 
elements, and PDFGroup
.
The Bookmarks filter element contributes bookmarks to the pages within the scope of the parent 
element. It is shorthand for a simple export/import operation. That is, the Bookmarks filter element is 
equivalent to using these expressions (in order):
1. Bookmarks
result to produce an intermediate Bookmarks XML document. The intermediate 
Bookmarks XML document is not returned to the client. 
2. Bookmarks
source element to then import the bookmarks from that Bookmarks XML document into 
the parent document. (See “Bookmarks Language” on page321
.)
As with the Bookmarks
source element, the bookmarks specified by this element are aggregated with 
bookmarks in other sibling source elements, if any. The aggregation replaces any bookmarks found in the 
pages within the scope of the parent element.
The filter element must contain at least one PDF
source element, which can be a child or be embedded 
within a child PDFGroup
element. 
Name
Description
source
Required. Identifies the name of the Bookmarks XML document. This name can be 
specified with an External Data URL. (See “External Data URL” on page152
and 
“Bookmarks Language” on page320
.)
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Center     168
Category
“Document components” on page144
Center
Specifies the center point of the page as the anchor point for a header or footer.
<Center> [0..1] 
<StyledText
or < PDF
source> [1] 
</Center>
Can be contained in the elements Footer
and Header
The content specified by the child elements is centered on the page. If the StyledText
element includes 
text-align attribute, that attribute is ignored.
If this element specifies a PDF
source element as a child, the first page of the document provides the 
content. 
This element does not support containment of the text within the middle third of the page. The text can 
go off the left and right sides of the page.
This element it does not support auto-wrapping of text. Use the styled text <p> element to wrap the text. 
Category
“Page content” on page148
ColorScheme
(Since 9.0) Color settings used in the PDF Portfolio. 
<ColorScheme
scheme="noScheme | blueScheme | brownScheme | darkblueScheme | 
darkbrownScheme | darkgreenScheme | lightblueScheme | 
lightgrayScheme | oliveScheme | orangeScheme | pinkScheme | 
purpleScheme | rustScheme | steeleScheme | taupeScheme | yellowScheme"
primaryText="color-specifier"
secondaryText="color-specifier"
background="color-specifier"
cardBackground="color-specifier"
cardBorder="color-specifier"
/>
Can be contained in the Portfolio
element.
The ColorScheme properties can be used for various components of a PDF Portfolio navigator, such as a 
built-in navigator, a navigator header, or portfolio welcome page. The named schemes match the colors 
that can be selected in Adobe Acrobat 9.0 and later.
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Comments     169
Attributes
Comments
PDF documents can contain annotations that appear on a page but are not considered to be part of the 
page content. Comments, in both the Assembler service and Acrobat, are the equivalent of what the PDF 
Reference calls markup annotations. They include items such as text notes, highlights, lines, and circles.
Comments elements enable comments contained in PDF documents to be exported, imported, and 
removed. The Comments elements include the following formats:
Comments
result. Exports comments from the child elements as an FDF or XFDF document.
Comments
source. Imports comments contained in an XFDF or FDF document into the pages within 
the scope of the parent element. 
Comments
filter. Represents the comments in its child elements, without exporting them as FDF or 
XFDF. 
Also see the NoComments
element, which specifies that comments be removed from the pages within the 
scope of the parent element.
Some operations that you can perform on comments also affect other annotation types, as noted in the 
individual elements.
Comments result
Specifies that the comments from the child elements be exported as an XFDF or FDF document.
<Comments 
Name
Description
scheme
Optional. The name of a built-in color scheme. These schemes are based on the 
schemes available in Adobe Acrobat 9.0. 
A value of noScheme allows the viewing application to use its default colors.
primaryText
Optional. The color of the primary text in a navigator, such as filenames and links. 
This color overrides the corresponding value in the scheme attribute, if 
specified. 
The value is a hexadecimal representation of a color (for example #000000) or 
an SVG color keyword name (for example black). See “Color-specifier” on 
page153
secondaryText
Optional. The color of the text other than primary text in a navigator. Overrides 
the corresponding value in the scheme attribute, if specified.
background
Optional. The color of the navigator background. Overrides the corresponding 
value in the scheme attribute, if specified.
cardBackground
Optional. The color of the navigator card background. Overrides the 
corresponding value in the scheme attribute, if specified.
cardBorder
Optional. The color of the navigator card border or the "selected" card. Overrides 
the corresponding value in the scheme attribute, if specified.
AdobeLiveCycleES4
DDX Language Elements
Assembler Service and DDX Reference
Comments result     170
result
="xs:string" 
format
="FDF" or "XFDF"
return
="trueor "false"
afterDate
="YYYYMMDD"
beforeDate
="YYYYMMDD"
byAuthor
="Author name"
byCategory
="Notes" or "DrawingMarkups" or "TextEditingMarkups" or "Stamps"
or "Attachments" or "All"
byType
="name1,name2,name3"
filter
="Exclude" or "Include" 
>
<PDF
sourceand/or <PDFGroup
[1..n] 
<Comments
filter[0..n]
<TargetLocale
[0..1]
</Comments>
Can be contained in the DDX
element, which is the DDX root.
To select the comments to export, add attributes that specify the selection criteria. If multiple selection 
attributes are included in a Comments element, comments are selected if they satisfy any of the criterion, 
as in an "or" logical operation. If a Comments element is nested within another Comments element, 
comments selected by one of the elements must also satisfy the conditions in the other element. This 
behavior is similar to an "and" logical operation. (See “Selection Attributes” on page171
.) For an 
explanation of the use of the Comment element selection attributes, see the “Introducing Document 
Description XML” on page15
.
The comments are exported as FDF or XFDF.
The result element must contain at least one PDF
source element, which can be a child or be embedded 
within a child PDFGroup
element. 
Category
“Document components” on page144
Attributes
Name
Description
result
Required. Specifies a name to be associated with the exported comments. This 
name must be unique among all result elements in the DDX document. This name 
can be specified with an External Data URL. (See “External Data URL” on page152
.)
format
Optional. Specifies the format to use for the exported comments. This attribute can 
have the following values:
FDF 
XFDF (default)
return
Optional. Specifies whether the exported comments are returned to the client. This 
attribute can have the following values:
true (default) - Exported comments are returned to the client.
false - Exported comments are not returned to the client but can be referenced 
as source from within a subsequent result element. 
Documents you may be interested
Documents you may be interested