Enhancing Adobe Acrobat Forms with

JavaScript : Take Your Forms to the

Next Level! 1st Edition Jennifer Harder
Visit to download the full and correct content document:
https://ebookmass.com/product/enhancing-adobe-acrobat-forms-with-javascript-take-
your-forms-to-the-next-level-1st-edition-jennifer-harder/
Jennifer Harder

Enhancing Adobe Acrobat Forms with

JavaScript
Take Your Forms to the Next Level!
2nd ed.
Jennifer Harder
Delta, BC, Canada

ISBN 978-1-4842-9469-7 e-ISBN 978-1-4842-9470-3

https://doi.org/10.1007/978-1-4842-9470-3

© Jennifer Harder 2017, 2023

Standard Apress

Trademarked names, logos, and images may appear in this book. Rather
than use a trademark symbol with every occurrence of a trademarked
name, logo, or image we use the names, logos, and images only in an
editorial fashion and to the benefit of the trademark owner, with no
intention of infringement of the trademark. The use in this publication
of trade names, trademarks, service marks, and similar terms, even if
they are not identified as such, is not to be taken as an expression of
opinion as to whether or not they are subject to proprietary rights.

The publisher, the authors and the editors are safe to assume that the
advice and information in this book are believed to be true and accurate
at the date of publication. Neither the publisher nor the authors or the
editors give a warranty, express or implied, with respect to the material
contained herein or for any errors or omissions that may have been
made. The publisher remains neutral with regard to jurisdictional
claims in published maps and institutional affiliations.

This Apress imprint is published by the registered company APress

Media, LLC, part of Springer Nature.
The registered company address is: 1 New York Plaza, New York, NY
10004, U.S.A.
Introduction
Welcome to the first step in an exciting journey called Enhancing Adobe
Acrobat Forms with JavaScript.
My journey into learning about Adobe software began more than 20
years ago when I started college. I took a two-year graphic
communications course in Vancouver, BC. While learning about how to
set up documents for print layout using QuarkXPress and later Adobe
InDesign, I created PDF files. At that point, I saw the PDF only as a
transition from one file format to the next production step, from layout
to the printing press. It never crossed my mind what else could be done
with PDF files in Adobe Acrobat.
Several years after graduating, while doing freelance work for one
of my clients, I began to investigate the features of Acrobat to discover
what else the program had to offer. In 2008, I decided to learn more
about web design and improve my layout skills in Adobe software. After
finishing three certificates in web design at Langara College Continuing
Studies, I realized that I wanted to help students learn more about
Adobe software. There were times through the journey when I read
different computer books and felt, “OK, I’ve finished this tutorial or
project, but how does this relate to the real world and what I’m trying
to accomplish?” In 2011, I became a teaching assistant at Langara
College, and this gave me the opportunity to write my own course on
introducing students to Adobe Acrobat. While writing it, I realized
there was a lot more that could be said about Acrobat than what I could
present in a three-evening course. At that point, I was looking at one
icon in the Acrobat menu that perplexed me. It was called JavaScript.
JavaScript in Acrobat? What was that doing there? The only
JavaScript that I knew about at that point was through building
websites. Back then I had built a few basic template forms using
LiveCycle Designer, MS Word, and Acrobat, but I had never used
JavaScript in the Acrobat program. I began to wonder how JavaScript
could improve my forms.
This is when and how the idea began for developing a book for
students on the topic of Acrobat and JavaScript. After years of research,
looking at Adobe and Acrobat forums, and studying the questions and
concerns users had when trying to add JavaScript to Acrobat, I came to
the following conclusions:
Users are looking for simple solutions to programming an Acrobat
form that they will use in real-world situations. Many are looking for
the same answers.
When documentation is not written in a simplified manner, the
average user becomes intimidated. They will shy away from using the
JavaScript menu and eventually give up and ignore the tool. To them,
JavaScript coding is like a foreign language, and the average person
who has not taken web design lessons does not have a clue what it
means or where the code should be inserted, since the form field’s
property dialog boxes look nothing like a web page.
At some point, it’s important to share with others what you have
learned about Acrobat and JavaScript and not keep your thoughts to
yourself. That’s what leads to innovative ideas. However, these
thoughts need to be organized so that the user can find the solution
quickly and be able to comprehend it. And these ideas need to be
kept up-to-date.
Shortly after compiling my notes for the first edition of this book,
Adobe introduced the latest version: Acrobat DC. I saw that the layout
of the program had changed and there was no book to show the user
how to add JavaScript in this new format. I had completed the first draft
of my Advanced Adobe course and had it approved by my program
coordinator at the college. In 2016, I realized I could reach a wider
audience if the book was published, so I approached Apress. They saw
my vision, and that is how this book came to be in your possession.
In October 2022, Acrobat has with latest releases removed the
reference to Document Cloud (DC) from its name; see
https://helpx.adobe.com/acrobat/using/whats-
new.html. This is the reason for the removal of “DC” from the title of
the second edition.
Newer versions of Adobe Acrobat also rely on web forms, which is a
new topic we will look at in Chapter 20.
Understanding How Acrobat and Its Forms Work
with JavaScript
If you are currently using Adobe Acrobat Pro DC or older versions, it’s
time to upgrade to the new Adobe Acrobat Pro, which we will be using
throughout this book. You can either acquire Adobe Acrobat Pro as a
stand-alone program through Adobe or get a Creative Cloud
subscription and enjoy all the exciting Adobe programs for a monthly
fee. Refer to these links and check if your computer’s operating system
meets the system requirements needed for the upgrade:
https://helpx.adobe.com/creative-cloud/system-
requirements.html
https://helpx.adobe.com/acrobat/system-
requirements.html
Make sure to follow the online instructions and tutorials for
installing and working with Acrobat and Creative Cloud.
If you already have Adobe Acrobat Pro installed on your machine
through the Creative Cloud subscription, you may notice that Acrobat
Pro in the upper-left edge of the program says “32-bit,” even if the
version number is 22.0 or newer, while the most recent version is 64-
bit. Even with regular updates your version may not make this switch
automatically.
I found that the best way to change this application’s bit from 32 to
64 is to uninstall the application from the Creative Cloud Desktop and
then install the program again. Refer to Figure I-1.
Figure I-1 Installing Acrobat again will change it to the 64-bit version
The benefit of changing to the 64-bit version is if you are running a
newer computer, you can ensure better performance, security, and
usage of memory when opening larger files. As of January 2023, Adobe
has been gradually fading out support for the 32-bit system; see
https://helpx.adobe.com/acrobat/kb/end-of-support-
acrobat-reader-32-bit-os.html.
If you are new to Adobe Acrobat, I encourage you to first read Adobe
Acrobat Classroom in a Book by Lisa Fridsma. Her book will give you a
basic overview of the new Acrobat features as well as some form basics.
However, that book does not go into detail regarding forms when
working with JavaScript. I consider my book to be a sequel for
intermediate and advanced users to take their forms to the next level.
Adobe Acrobat Pro will allow you to add form fields to any PDF file,
as I will explain further in Chapter 1. It can even work with pre-existing
form fields that were created in Adobe InDesign CC when the file was
exported as an interactive PDF. However, it’s important that your client
views and interacts with the forms in Acrobat Pro, Standard, or Acrobat
Reader. Other PDF readers, and some older browsers, have been known
to corrupt the JavaScript programing when saving a document, so keep
this in mind when you email the forms to clients. Make sure your clients
have the latest version of Acrobat Reader, which is free, and that their
browser is up-to-date as well.
Another reason some users may not be able to interact with
JavaScript is that they may have disabled the use of JavaScript in the
Acrobat Application under Edit ➤ Preferences Categories JavaScript.
See Figure I-2 for how your JavaScript preferences should appear in
Adobe Acrobat Pro.
Figure I-2 Acrobat Pro Preferences menu for enabling and disabling JavaScript and
security features
 The following is an explanation from the Adobe website on some of
the settings. See
https://helpx.adobe.com/acrobat/using/javascripts-
pdfs-security-risk.html for more information.
Enable Acrobat JavaScript: Uncheck this to disable JavaScript
completely or restrict JavaScript through APIs. This setting by default
is enabled.
Enable menu items JavaScript execution privileges: This enables
executing JavaScript by clicking menu items. When off, privileged
JavaScript calls can be executed through the menu. Executing
nonprivileged JavaScript calls through menu items is not blocked
whether this box is checked or not. This setting by default is disabled.
Enable global object security policy: This allows JavaScript
globally through APIs or trusts specific documents containing
JavaScript. This setting by default is enabled.
Note that you will not be working with any JavaScript that could
create a security risk, so you can leave the JavaScript Security area at
the default settings for these chapters as you work with the files you
download. However, I will show you how to enable the JavaScript
Debugger in Chapter 5 using the Preferences dialog box.
In most cases, Adobe Acrobat will autodetect in a PDF where most
form fields can be added in a form, but it’s not a perfect science. It’s up
to you as the author to edit and test your forms for errors as you build
them and add your JavaScript code.

What to Expect from This Book

Enhancing Adobe Acrobat Forms with JavaScript covers up-to-date, real
working examples that you can easily download, practice with, and edit
to suit your own projects. Using screenshots from Adobe Acrobat Pro,
users of previous versions will also be able to utilize these techniques.
This book also shows work-arounds and solutions to various form
issues you might encounter. JavaScript does not need to be scary. Feel
empowered by it and improve your PDF documents!
What You’ll Learn
You’ll learn how to do the following in this book:
Create calculations, rating forms, and QR code stamps using the form
elements
Understand simplified field notation and basic JavaScript for Acrobat
Use buttons for navigation
Create complex forms that include drop-down and list boxes in
combination with other form fields such as check boxes and radio
buttons
Use the Action Wizard and JavaScript
Improve form navigation and the printing of forms
Implement various types of alerts and custom validations to improve
client-entered data and avoid errors
Get new information on Adobe Sign and how it relates to Acrobat
Forms online

Note You can find the project files for the book at
www.apress.com/9781484228920.
Any source code or other supplementary material referenced by the
author in this book is available to readers on GitHub. For more detailed
information, please visit http://www.apress.com/source-code.
Acknowledgments
Because of their patience and advice, I would like to thank the following
people, for without them I could never have written this book:
My parents, for encouraging me to read large computer textbooks
that would one day inspire me to write my own books
My dad, for reviewing the first draft before I sent a proposal
My program coordinator, Raymond Chow, at Langara College, who
gave me the chance to teach evening courses and allowing me to find
new and creative ways to teach software
My various freelance clients who I have learned from and researched
more about forms and form layout through working on their projects
I would also like to thank Spandana Chatterjee and Mark Powers at
Apress for showing me how to lay out a professional textbook and
pointing out that even when you think you’ve written it all, there’s still
more to write. Also, thanks to the technical reviewer for providing
encouraging comments and to the rest of the Apress team for being
involved in the printing of this book and making my dream a reality
again. I am truly grateful and blessed.
Table of Contents
Part I: Basic Form Improvements
Chapter 1:​A Fundamental Forms Primer
Forms Review
Fields Refresher
Properties Refresher
Text Box Field Properties and Date Field Properties Dialog
Boxes
Dropdown Properties Dialog Box
List Box Properties Dialog Box
Check Box Properties Dialog Box
Radio Button Properties Dialog Box
Button Properties and Image Properties Dialog Box
Digital Signature Properties Dialog Box
Barcode Properties Dialog Box
Tabs Refresher
Editing Your Form with the More Menu and Right Pane
Setting the Field Tab Order Using the Menu Options
Clearing a Form While Working
Summary
Chapter 2:​Introduction to Actions
Getting Started
Rating Forms Value Averaging and Sum:​Working with Text
Fields
The Validate Tab
The Calculate Tab for the Grand Total Using Sum
 Sum and Averaging Using Check Boxes or Radio Buttons with
Text Fields
Using Radio Buttons on Page 3 of the Project
Using Check Boxes on Page 3 of the Project
Turning Check Boxes into Radio Buttons
Basic Action Button Triggers for Reset Buttons and Printing
Buttons
Reset Button
Print Form Button
Summary
Chapter 3:​Creating a QR Code Custom Stamp
Customizing Your QR Code Stamp
QR Code Creation
Using the Stamp Tool
Final Thoughts:​QR Code for Professional Printing
Summary
Chapter 4:​Buttons, Navigation, Form, and Nonform Actions
Creating a Button Icon
Example of a Button as a Label Only
Example of a Button Combination of Icon Only
Nonform Properties Actions
Pages
Bookmarks
Web and Custom Hyperlinks
Rich Media Nonform Navigation Buttons
Layers Basic Actions
 Other Nonform Actions That Can Affect Sticky Note or
Markup Tools Indirectly
Triggers for Actions
Choose an Action That Requires No Code
Newsletter Navigation with Buttons
Form Navigation with a Button as a Helpful Hint
Adding a Comb of Characters
Before Comb and After Comb
More Action Triggers to Show and Hide
Hide and Clear Fields Button
Set Layer Visibility
Using Bookmarks
Using Buttons
Summary
Part II: Simplified Field Notation and Basic JavaScript
Chapter 5:​Introduction to Simplified Field Notation and JavaScript
Getting Started
Text Field, Date, and Drop-Down List Properties
Actions Tab
Format Tab
Validate Tab
Calculate Tab
Check Box, Radio Button, Image Field, and Button Properties
List Box Properties
Digital Signature Properties
Barcode Properties
 Global Document JavaScript
Web Links and References
Regular Forms vs.​E-Signature Forms
JavaScript and Acrobat on the Document Level
Summary
Chapter 6:​Basic and Complex Calculations
Getting Started
Sum Value
Simplified Field Notation
JavaScript Custom Calculation Script
Final Thoughts on Working with the Calculate Tab
JavaScript Script Validation for Displaying Zero
The Final Line of Code
Drop-Down Alternatives
Set Field Calculation Order
Resetting Your Field of Focus
Summary
Chapter 7:​Format Calculations
Number Formatting
Formatting with a Percentage
A Workaround for the Percentage
Reset Fields with JavaScript
Date Formatting
Date Formatting with JavaScript
Time Formatting
Time Formatting with JavaScript, a Custom Example
 Comb of Characters for Dates
Special Formatting
Final Thoughts
Drop-Down Alternatives
More Information on Adding Decimal Places and Leading
Zeros
Summary
Chapter 8:​Various JavaScript Alerts, Notes, and Time Stamps
Alert Types
Create a Document JavaScript
Viewer Version and Validation Alert
Document Actions
Document Will Close
Document Will Print
Alerts Working with Buttons
Adding a Comment Note, Signature, and Time Stamp
Signature Field and Time Stamp
Summary
Chapter 9:​Create Help for Clients with Rollover Text and Alerts
The Rollover Method
Mouse Enter
Mouse Exit
Longer Array Example (Optional)
Extra Noncustom JavaScript Check Box Example
How to Show and Hide Fields with JavaScript
The Default Text Method
 The Alert Method
Customer’s Full Name
Date
Customer Order Code
Customer’s Company Name
How to Duplicate Text for Multiple Fields and Make Fields
Read-Only
Set Fields to Read-Only with JavaScript
Final Thoughts
Summary
Chapter 10:​Various Types of Formatting with JavaScript
Adding Global Formatting to Text Fields
Color Properties
Array and Variable Examples of Formatting Properties
Multiline Buttons
Multiline Text
Complex Formatting Using Check Boxes and a Text Field
Rich Text Formatting for Text Fields and Comments
Comment Example
Final Thoughts on Formatting with Text
Silent Printing
Options for Submit Button Using Email
Summary
Part III: Working with More Complex Forms
Chapter 11:​Validation with Text Boxes, Alerts, and Radio Buttons
Money Transfer Example
 Alternate Way to Work with Radio Buttons Without Alerts
Changing the Shipping Price Using Radio Buttons
Additional Radio Button Example with JavaScript and Text
Fields and How to Change Data for Time
Setting Up the Text Fields
Check Box Variation with Date Text Fields
Notes on Changing Formatting Options for Radio Button,
Check Box, and Button Style
Text Field Validation with Regular Expressions
Telephone Validation
Name Validation
Account Number Validation
Email and URL Validation
Another Phone and Date Example with Two Variables
Final Thoughts on Formatting Fields
Summary
Chapter 12:​Working with Dropdown Lists
Current Skills Request Form
Parts Order Form
Drop-Down Lists with Select Dates and Discounts
Final Thoughts
Load a Lengthy Single Drop-Down or List Menu
Tips on Changing Custom Formatting for Drop-Down Lists
with JavaScript
Summary
Chapter 13:​Working with List Boxes
List Box Priority List with Control Buttons
 The Add Button
The Delete Button
The Clear or Reset Button
The Up Button
The Down Button
Check Box, Drop-Down, and List Box:​Example 1
Check Box, List Box, and Multi-Drop-Down:​Example 2
Button Slide Show Variation
Extra Example Priority List Improved
Final Thoughts
Hidden Fields
Using List Boxes for a Number Rating
Notes on Changing Custom Formatting for List Boxes
Summary
Chapter 14:​Advanced Navigation:​The Pop-Up Menu
The Pop-Up Menu Example
Add a Pop-Up Menu Using a Bookmark
Final Thoughts
Summary
Part IV: Beyond the Basics
Chapter 15:​Action Wizard and JavaScript
Working with the Action Wizard
Reuse JavaScript from Chapter 8
Is It a Custom Action or a Custom Command?​
Create and Manage Custom Commands
Summary
Chapter 16:​Multistate Check Boxes
The Problem of Multistate Check Boxes
Bonus Star Rating Idea
Select All or Deselect All Check Boxes at Once
Summary
Chapter 17:​Importing an Image into a Button
Creating the Button
Summary
Chapter 18:​Multiple Formatting
The Problem of Multiple Formatting
Option 1:​Do It Yourself
Price Script
No Price Script
Adding a Degree Symbol and Formatting Range
Option 2:​Contact a Professional
Summary
Chapter 19:​Digital Signatures and Barcodes
Digital Signatures and Security
Working with Digital Signatures and Other Adobe Security
Tools
Create a Security Puzzle
Barcodes
Summary
Chapter 20:​What Are E-Signature Forms and Web Forms?​
A Brief Look at Request E-Signatures and Resources
What Are Web Forms?​
 Summary
Part V: Putting It into Practice
Chapter 21:​Homework Assignments
Homework Assignment 1:​Show and Hide
Homework Assignment 2:​Working with JavaScript to Create
Formulas
Area of a Circle A = π r 2
Field:​CircumferenceRow​1 Circumference of a Circle C =​2 π
r
Field: VolumeRow1 Volume of a Sphere V = 4/3 π r3
Field:​FahrenheitRow1 Celsius to Fahrenheit to Formula.​(°C
x 9/​5) + 32 =​°F.​
Field:​CelsiusRow1_​2 Fahrenheit to Celsius Formula.​(°F -
32) x 5/​9 =​°C
Homework Assignment 3:​Custom Validation and Regular
Expressions
Homework Assignment 4:​Personal Drop-Down List Menu and
Definitions Text Box
Summary
Index
About the Author
Jennifer Harder
has worked in the graphic design
industry for more than 15 years. She has
a degree in graphic communications and
is currently teaching Adobe Acrobat and
Adobe Creative Cloud courses at Langara
College. She is the author of several
Apress books and related videos.
About the Technical Reviewer
Sourabh Mishra
is an entrepreneur, developer, speaker, author, corporate trainer, and
animator. His programming experience includes C/C++, ASP.NET, C#, VB
.NET, WCF, SQL Server, Entity Framework, MVC, Web API, Azure, jQuery,
Highcharts, and Angular. Sourabh has been awarded MVP status. He has
the zeal to learn new technologies and enjoys sharing his knowledge on
several online community forums.
He is a founder of IECE Digital and Sourabh Mishra Notes—online
knowledge-sharing platform where people can learn new technologies
easily and comfortably.
He can be reached through the following platforms:
Email: sourabh_mishra1@hotmail.com
YouTube:
https://www.youtube.com/@SourabhMishraNotes
Instagram:
https://www.instagram.com/sourabhmishranotes/?
hl=en
Twitter: @sourabh_mishra1
Part I
Basic Form Improvements
© The Author(s), under exclusive license to APress Media, LLC, part of Springer
Nature 2023
J. Harder, Enhancing Adobe Acrobat Forms with JavaScript
https://doi.org/10.1007/978-1-4842-9470-3_1

1. A Fundamental Forms Primer

Jennifer Harder1
(1) Delta, BC, Canada

Chapter Goal: Creating the right form before you add JavaScript to
your PDF fields takes time and careful planning. Therefore, it’s
important that you become familiar with each of the form tools and the
properties that are associated with them. This chapter provides a quick
overview of forms, fields, properties, and tabs that will serve as the
basis for future chapters. If you are already comfortable with these
topics, feel free to jump ahead to Chapter 2.

Forms Review
Each form field has within it properties that can be accessed by right-
clicking the form field. The properties of that form field are organized
by tabs. Each form field has slightly different properties and therefore
different tabs.
Throughout this book you will be working on lessons with a variety
of different PDF forms and documents for a fictitious company called
the Tourmaline Mining Corporation.
Each chapter (except for Chapters 1 and 5) comes with JavaScript in
a .txt file and PDF files that you can open and compare. You can either
view the final PDF file or use the start PDF file and follow along with
the notes in these chapters. You can find the link to these files in the
introduction and then locate that specific Chapter Project folder.
 Note Please be aware that the PDF files used with this book should
be opened only in Adobe Acrobat Pro, Acrobat Reader, or earlier
versions of Acrobat DC and not in your web browser or any other
PDF creation/reader program. Other PDF readers have been known
to corrupt the JavaScript code within the Acrobat PDF files, and then
the calculations fail to work.

Upon opening Acrobat Pro, make sure to check your preferences at Edit
➤Preferences ➤ Forms. Refer to Figure 1-1. They should be set to the
default settings shown in Figure 1-2.

Figure 1-1 Open Acrobat Pro using your Creative Cloud Desktop App
Figure 1-2 Default settings for the Forms tool found in the Preferences
In this case, all of the General check boxes are enabled.
Automatically calculate field values
Automatically adjust tab order when modifying fields
Show focus rectangle
Show text field overflow indicator
Show field preview when creating or editing form fields
Automatically detect Form Fields
Auto-enable text editing in Prepare Form
Highlight Color’s check is enabled to show border hover color for
fields. Light blue is the color for highlighted fields, and red is the
highlight color for required fields.
Auto-Complete is set to Off, and there is a description below it
explaining what this setting means. Other options in the list are Basic or
Advanced.
At this point, if these are your settings, you can click Cancel and Exit
or make your settings like mine and click OK. These preferences are not
saved with the forms but will help you interact with the forms as you
work.
If you are working with Manage Barcode Parameter, refer to this
topic later in the chapter and Chapter 19.
The book assumes you are familiar with filling in basic forms or
have used PDF forms in the past. If you are unsure of how to use the
Prepare Form tool and its autodetection of fields in Acrobat Pro, this
section provides a refresher.
Draw your form either by hand or create the basic structure in MS
Word, Adobe Illustrator, or Adobe InDesign, and then decide what steps
you want the form to do and accomplish. Then plan how to execute
your goals. Is what you want the form to do possible? Do you need to
simplify the form? Or do you need to learn more about the topic of
forms to create what you want? Make sure to consult with your team or
clients as you build the form before you begin to add interactivity.
Except for the program of Adobe InDesign, you cannot assemble the
form’s interactive fields outside of Acrobat, so you need to make a PDF
to do that. Until you are ready to make the PDF, continue to assemble
the form in your layout program such as MS Word until it looks the way
it should. Then save the MS Word file (.doc or .docx). Then create the
PDF. For example, in the case of MS Word, I can use my Acrobat tab to
quickly create a PDF or use my File Print tab. Refer to Figure 1-3.

Figure 1-3 Use the MS Word Ribbon with the Acrobat tab or the Print settings to
create your PDF
Once you have the final PDF, open it in Acrobat Pro and follow these
steps to add interactivity:
1. Click the Tools tab and click the Prepare Form tool, which is found
in the Forms & Signatures section (see Figure 1-4).
Figure 1-4 Location of Prepare Form tool
2. You can use this tool whether you have a PDF Form open or not.
While in the tool, choose, in this case, Single File, locate your file
(you can change the files if the thumbnail is not correct), and make
sure that form field autodetection is on. Do not select “This
document requires signatures” as we will look at that option in
Chapter 20 in more detail (Figure 1-5).
Figure 1-5 The Prepare Form tool when you first create a new form
3. Click Start. Acrobat will scan the file for fields; if it detects any, it
will create the field. However, it is not perfect in its detection, so
you may have to add, delete, or edit some fields afterward.

4. Once you have added your fields, save the file as a new PDF
(Ctrl/Cmd+S). Choose to save the file on your computer and then
 select a folder to save the file into. Make sure that the “Convert to”
option is disabled. The new PDF is now an interactive form. Refer to
Figure 1-6.

Figure 1-6 Saving the new PDF form in a folder after autodetection is completed

Note You can now, with the Prepare Form tools, create a PDF form
in three more ways; refer to Figure 1-5: directly from your scanner,
as a blank new document using the Create New option, or using the
Create a Web form. We’ll look at that option in Chapter 20.

You can now begin adding your formatting and actions to the
properties of each field. Test it, and ask others to try it on their
computer, before you email it to your clients. Always keep a backup on a
disk or USB drive in case something happens to your main computer.
Also, make a printout of the PDF and all code in case you need to refer
to it later for another project. In this book I have placed a copy of the
code in the .txt files in each chapter for reference.
 Once the fields are in the saved form, you can open the fields at any
time with the Prepare Form tool; you do not need to run the
autodetection again for that form. Refer to Figure 1-7.
You can exit the Prepare Form area partially by toggling the
Preview/Edit button in the upper-right (Figure 1-7). To exit the Prepare
Form tool completely, you must click the Close button in the upper-
right (Figure 1-7).
Figure 1-7 The Prepare Form tool and the tools for adding and working with the
fields. Note the Preview/Edit toggle and Exit (Close) buttons in the upper right. Also
note the view of a form while in Edit mode before switching to Preview
 For more information on basic forms or basic form creation, check
out the following links before you proceed any further in this book:
https://helpx.adobe.com/acrobat/using/pdf-forms-
basics.html
https://helpx.adobe.com/acrobat/using/create-
form.html
https://helpx.adobe.com/acrobat/using/creating-
distributing-pdf-forms.html
https://helpx.adobe.com/acrobat/using/filling-
pdf-forms.html
https://helpx.adobe.com/acrobat/using/pdf-form-
field-properties.html
The Adobe HelpX area for forms has additional links as well, and we
will look at some of those options later. But you can use this area as a
resource when you need to work with basic forms.
While working in the Prepare Form Tool area, you will come across
other form tools in the right-side pane, such as the Align and Distribute
options, and in the More drop-down menu (Figure 1-7). I will go into
more detail about this area and the JavaScript area later in the book.
However, you can also refer to the previous web links for more specific
details. Refer to Figure 1-8.
Figure 1-8 Additional options in the right-hand pane of the Prepare Form tool

Fields Refresher
Fields can be blank and inactive, or they can contain a script that, upon
entering or clicking a trigger, sets the action in motion. For example,
they can execute a menu item or import form data. In Acrobat Pro, the
Prepare Form Menu tool area contains all the field options listed next
plus the Selection tool and the newer options Edit Text and Images and
Add Text.
Fields can be used in any form, while the Selection tool is just an
arrow that allows you to select, size, and move them around. From left
to right, let’s look at the tool options in this section more closely; refer
to Figure 1-9.

Figure 1-9 Editing and Field options for forms

Selection tool: This arrow allows you select, size, and move fields. It
can also be used to edit text boxes when they are added; you double-
click with the arrow on them. Refer to the arrow in Figure 1-9.
Edit Text and Images: This is not a field option, but it allows you to
edit the text or images surrounding the field while remaining in the
Prepare Form tool and saves you time rather than having to close the
tool and use the Edit PDF tool instead. When text is selected, the right
pane’s Format area changes so that you can edit the selected text or
image that is surrounded by a bounding box. Images can be scaled
and rotated as well. Refer to Figure 1-10.
Figure 1-10 Text change settings in the Prepare Form tool and the selected text with
a bounding box
Add Text: This is not a field option, but it allows you to add a new
text box while remaining in the Prepare Form tool and saves you time
rather than having to close the tool and use the Edit PDF tool instead.
 Select the tool and click a location on the page that you want the
text to appear and start typing, or when you select the tool, drag out a
rectangular bounding box for a paragraph area and start typing.
Again, the bounding box will appear around the text, and you can
scale and rotate as well as edit the format of the text on the right.
Refer to Figures 1-10 and 1-11.

Figure 1-11 Adding text to a page while in the Prepare Form tool and tip message

Click the Selection tool arrow if you want to exit the editing
options.
Now look at the form fields. These can be added to the form when
you first select them and then click the page. Use your mouse to
hover over each field to read its description and related name.
Text field: Type text, words, or numbers into the field. Refer to
Figure 1-12.
Figure 1-12 Adding a text field
Check box: Select one or multiple options of an item. Refer to Figure
1-13.

Figure 1-13 Adding a check box

Radio button: Select one option from a group: yes or no. These
options can be mutually exclusive, and you can have more than one
group in a form. You must have at least two radio buttons and can
add a second if prompted with the initial message. Refer to Figure 1-
14.
Figure 1-14 Adding a radio button
List box: Select one or multiple items in a list of choices. Refer to
Figure 1-15.
Figure 1-15 Adding a list box
Dropdown list: Select an option or choice from a list. Refer to Figure
1-16.

Figure 1-16 Adding a drop-down list

Button: This initiates an action such as reset (Clear), submit, and

print. Refer to Figure 1-17.
Figure 1-17 Adding a button field
Image field: This is the same as Button, only with some JavaScript
added (more on this topic in Chapter 17). Refer to Figure 1-18.

Figure 1-18 Adding an image field

Date field: This is the same as a text field but is preformatted to date.
It can operate as a date picker. Refer to Figure 1-19.
Another random document with
no related content on Scribd:
[6] Et disent que on tenoit à grant sens d’un signeur,
quant il a pluiseurs guerres en un temps, et il en poet
l’une atriewer, l’autre apaisier et le tierce guerroiier.
Tant li moustrèrent de raisons qu’il s’i acorda et pria
5 au prelat dessus dit qu’il y volsist aler. Li evesques
ne li volt mies escondire, ains se mist au chemin et
en ala celle part, mais il perdi sa voie et revint en arrière
sans riens faire. Si raporta au roy d’Engleterre
que li rois David d’Escoce n’avoit point de conseil
10 de donner triewes ne souffrance, ne de faire pais ne
acord, sans le gret et le consent dou roy Phelippe de
France. De ce raport eut li rois englès plus grant
despit que devant; si dist tout hault que ce seroit
amendet temprement, et qu’i[l] atourroit telement le
15 royaume d’Escoce que jamais ne seroit recouvret. Si
manda par tout son royaume que cescuns fust à
Evruich à le feste de Paskes, apparilliés d’aler là où
il les vorroit mener, excepté chiaus qui s’en devoient
aler en Bretagne avoecques monsigneur Robert d’Artois
20 et la contesse de Montfort.

§ 184. Li jours de le Paske et li termes vint. Li

rois Edowars tint une grant court à Evruic. Tout li
prince et li signeur et li chevalier d’Engleterre, qui
pour le temps y estoient, y furent et ossi grant fuison
25 de le communauté dou pays. Et furent là par l’espasse
de trois sepmainnes sans chevaucier plus
avant, car bonnes gens s’ensonniièrent entre le roy
englès et le roy d’Escoce, par quoi il n’i ot adonc
point de guerre. Et fu une triewe prise, jurée et
30 acordée à tenir deux ans, et le fisent li Escot contremer
deu roy de France. Par ensi se deffist ceste
[7] grosse chevaucie, et departi li rois englès ses gens et
leur donna congiet de raler en leurs hostelz. Et il
meismes s’en revint à Windesore et envoia adonc
monsigneur Thumas de Hollandes et monsigneur
 5 Jehan de Hartecelle à Bayone à tout deux cens armeures
de fer et quatre cens arciers, pour garder les
frontières contre les François.
Or vous parlerons de l’armée monsigneur Robert
d’Artois [et de sa compaignie[251]], et comment il arrivèrent
10 en Bretagne. En ce temps escheirent les Paskes
si hault que, environ closes Paskes, on eut l’entrée
dou mois de may. De quoi, en le moiiené de ce mois,
la triewe de monsigneur Charles de Blois et de la contesse
de Montfort devoit fallir. Si estoit bien messires
15 Charles de Blois enfourmés dou pourcach que la contesse
de Montfort avoit fait en Engleterre et de l’ayde
et confort que li rois li devoit faire. Dont messires
Loeis d’Espagne, messires Charles Grimaus, messires
Othon Doriie estoient establi sus le mer à l’encontre
20 de Grenesie, à trois mille Geneuois et mille hommes
d’armes en trente deus gros vaissiaulz espagnolz tous
armés et tous fretés, et waucroient sus le mer attendans
leur revenue. D’autre part, messires Gautiers
de Mauni et li signeur de Bretagne et d’Engleterre,
25 qui dedens Hembon se tenoient, estoient durement
esmervilliet de leur contesse de ce que elle demoroit
tant, et si n’en ooient nulles certainnes nouvelles.
Nompourquant moult bien supposoient que elle ne
sejournoit mies trop bien à se grant aise, et ne se
30 doubtoient de aultre cose que elle n’euist aucun dur
[8] encontre sus mer de ses ennemis; se n’en savoient
que penser.

§ 185. Ensi que messires Robers d’Artois, li

contes de Pennebruc, li contes de Salebrin et li
5 aultre signeur et chevalier d’Engleterre et leurs gens,
avoech la contesse de Montfort, nagoient par mer au
lès devers Bretagne et avoient vent à souhet, au departement
de l’isle de Grenesie, à l’eure de relevée,
il perchurent le grosse navie des Geneuois dont
10 messires Loeis d’Espagne estoit chiés. Dont disent
leur maronnier: «Signeur, armés vous et ordenés,
car veci Geneuois et Espagnolz qui viennent et qui
vous approcent.» Lors sonnèrent li Englès leurs
trompètes et misent leurs pennons et leurs estramières
15 armoiies de leurs armes et de Saint Jorge.
Et s’ordonnèrent bien et sagement et s’encloirent de
leurs arciers; et puis nagièrent à plain voile, ensi
que li tamps l’aportoit. Et pooient estre environ quarante
six vaissiaus, que grans que petis. Mais [nuls[252]]
20 si grans ne si fors de trop n’en y avoit que messires
Loeis d’Espagne en avoit neuf; et entre ces neuf
avoit trois galées qui se remoustroient dessus tous les
aultres. Et en cescune de ces trois galées qui se
remoustroient
dessus tous les aultres estoient li troi
25 corps des signeurs, messires Loeis, messires Charles
et messires Othes.
Si s’approcièrent li vaissiel, et commencièrent Geneuois
à traire de leurs arbalestres à grant randon,
et li arcier d’Engleterre ossi sus eulz. Là eut grant
[9] tret des uns as aultres, et qui longement dura, et
maint homme navret et bleciet. Et quant li signeur,
li baron, li chevalier et li escuier s’approcièrent, et
qu’il peurent des lances et des espées venir ensamble,
5 adonc y eut dure bataille et crueuse, et trop bien s’i
portèrent et esprouvèrent li un et li aultre. Là estoit
messires Robers d’Artois qui y fu très bons chevaliers,
et la contesse de Montfort meismement armée, qui
bien valoit un homme, car elle avoit coer de lyon, et
10 tenoit un glave moult roide et bien trençant, et trop
bien s’en combatoit et de grant corage.
Là estoit messires Loeis d’Espagne en une galée,
comme bons chevaliers, qui moult vaillamment et
de grant volenté requeroit ses ennemis et se combatoit
15 as Englès, car moult les desiroit à desconfire,
 pour li contrevengier dou damage qu’il avoit eu et
receu ceste propre anée, assés priès de là, ou camp de
Camperli. Et y fist li dis messires Loeis grant fuison
de belles apertises d’armes. Et jettoient li Espagnol
20 et li Geneuois, qui estoient en ces gros vaissiaus, d’amont
gros barriaus [de fer[253]], et archigaies dont il
travilloient moult les Englès. Là eurent li baron et
li chevalier d’Engleterre moult à faire et un dur rencontre,
et trouvèrent l’armée des Espagnols et des
25 Geneuois moult forte et gens de grant volenté.
Si commença ceste bataille moult tart et environ
vespres, et les departi li nuis, car il fist moult obscur
sus le vesprée; et se couvri li airs moult espès, si
ques à painnes pooient il recognoistre l’un l’autre.
30 Si se retraisent cescuns et se misent à l’ancre, et
[10] entendirent [à] appareillier les bleciés et les navrés et
remettre à point; mais point ne se desarmèrent, car
il cuidièrent de rechief avoir le bataille.
 § 186. Un petit devant mienuit s’esleva uns vens,
5 uns orages et uns tempestes si très grans et si très
horribles que il sambloit proprement que li mondes
deuist finer. Et n’i avoit si hardi ne si oultrageus, de
l’une part ne de l’autre, qui ne volsist estre bien à
terre, car ces barges et ces naves hurtoient les unes
10 as aultres telement que ce sambloit proprement que
elles deuissent ouvrir et fendre. Si demandèrent
conseil li signeur d’Engleterre à leurs maronniers,
quel cose leur estoit bon à faire. Il respondirent que
d’yaus traire [à terre[254]] au plus tost qu’il poroient,§
15 car la fortune estoit si grande sus mer que, se li vens
les y boutoit, il seroient tout en peril d’estre noiiet.
Dont entendirent il generalment à traire les aultres
amont, et misent les singles ensi qu’à demi-quartier;
et tantost eslongièrent il le place où il avoient jeu à
20 l’ancre.
D’autre part, li Espagnol et li Geneuois n’estoient
mies bien assegur de leurs vies; ançois se desancrèrent
ensi que li Englès, mais il prisent le parfont,
car il avoient plus grans vaissiaus et plus fors que li
25 Englès n’euissent; si pooient mieulz souffrir et attendre
[le hustin et[255]] le fortune de le mer que li Englès
ne fesissent. Et ossi, se leur gros vaissiel euissent froté
à terre, il euissent esté en peril d’estre brisiet et
[11] romput. Pour tant, par grant sens et avis, il se boutèrent
avant ou parfont. Mès, à leur departement,
il trouvèrent quatre nefs englesces cargies de pourveances
et de chevaus, qui s’estoient tenu en sus de
5 le bataille. Si eurent bien conscience, [quel tamps
ne[256]] quel tempès qu’il fesist, de prendre ces quatre
vaissiaus et d’atachier as leurs et emmener après
yaus. Et saciés que li vens et li fortune qui estoit si
grande les bouta, avant qu’il fust jours, plus de cent
10 liewes en sus dou lieu où il s’estoient combatu. Et
 les nefs monsigneur Robert d’Artois prisent terre à
un petit port assés priès de le cité de Vennes, dont
il furent tout resjoy, quant il se trouvèrent à terre.

§ 187. Ensi et par ceste grant fortune se desrompi

15 la bataille sus mer de monsigneur Robert d’Artois et
de se route à l’encontre de monsigneur Loeis d’Espagne
et de ses gens. Si n’en scet on à qui bonnement
donner l’onneur, car il se partirent tout maugret
yaus et par le diverseté dou temps. Toutes voies,
20 li Englès prisent terre assés priès de Vennes, et issirent
hors des vaissiaus et misent leurs chevaus sus
le sabelon et toutes leurs armeures et leurs pourveances;
et puis eurent conseil et avis dou sourplus,
comment il se maintenroient. Si ordonnèrent à
25 traire leur navie devers Hembon, et yaus aler devant
Vennes, car assés estoient gens pour le assegier; si
s’esmurent et chevaucièrent tout ordeneement celle
part, et n’avoient mies grant fuison à aler, quant il
s’i trouvèrent.
[12] Adonc estoient dedens le cité de Vennes, [pour
monsigneur Charlon de Blois[257]] messires Hervis de
Lyon et messires Oliviers de Cliçon, doi vaillant
chevalier durement, comme chapitainne; et ossi y
5 estoient li sires de Tournemine et li sires de Lohiac.
Quant cil chevalier de Bretagne veirent venus les
Englès, et qu’il s’ordonnoient pour yaus assegier,
si n’en furent mies trop effraet, mès entendirent au
chastiel premierement et puis as garites et as portes.
10 Et misent à çascune porte un chevalier et dix hommes
d’armes et vingt [archiers parmi les[258]] arbalestriers,
et s’aprestèrent bien pour tenir et garder le
cité contre tous venans.
Or, vous parlerons de monsigneur Loeis d’Espagne
15 et de se route.
 § 188. Saciés que, quant cilz grans tourmens et
ceste fortune eurent pris et eslevet et boutet en mer
le dessus dit monsigneur Loeis, il furent toute ceste
nuit et l’endemain tant c’à nonne moult tourmenté
20 et en grant aventure de leurs vies. Et perdirent par
le tourment deux de leurs vaissiaus et les gens qui
ens estoient. Quant ce vint au tierc jour environ
prime, li temps cessa, li mers s’aquoisa. Si demandèrent
li chevalier as maronniers de quel par il
25 estoient plus priès de terre, et il respondirent: «dou
royaume de Navare.» Lors furent li patron moult
esmervilliet, et disent que li vens les avoit eslongiés
ensus de Bretagne plus de six vingt liewes. Si se misent
[13] là à l’ancre et attendirent le marée: si ques,
quant li flos de le mer revint, il eurent assés bon
vent pour retourner vers le Rocelle, et costiièrent
Bay[o]ne, mais point ne l’approcièrent. Et trouvèrent
5 quatre nefs de Bayonois qui venoient de Flandres;
si les assallirent et prisent tantos, et misent à
bort tous chiaus qui dedens estoient. Et puis nagièrent
vers le Rocelle, et fisent tant en briefs jours
qu’il arrivèrent à Garlande, et là se misent il à terre.
10 Si entendirent des nouvelles que messires Robers
d’Artois et ses gens estoient à siège devant le cité de
Vennes. Si envoiièrent devers monsigneur Charlon
de Blois qui se tenoit à Rennes, à savoir quel cose il
voloit qu’il fesissent. Or lairons nous un petit à parler
15 François, et parlerons de chiaus qui estoient au siège
devant Vennes.

§ 189. Messires Robers d’Artois, si com vous poés

oïr, avoit assegiet le citet de Vennes à mille hommes
d’armes, et trois mille arciers, et couroit tout le pays
20 environ et l’ardoit, exilloit et destruisoit tout jusques
à Dinant [en Bretaigne[259]] et jusques à le Roce Periot
et jusques à Ghoy le Forest. Et n’osoit nulz demorer
 sus le plat pays, s’il ne voloit le sien mettre en aventure,
tout jusques au Souseniot et le Roce Bernart.
25 Le siège durant devant Vennes, il y eut as bailles
de le ville tamainte escarmuce et maint assaut et
tamaint grant fait d’armes fait. Li chevalier qui dedens
estoient, li sires de Cliçon et messires Hervis de
Lyon et leur compagnon s’i portoient vaillamment,
[14] et moult y acqueroient grant grasce, car bien estoient
songneus de deffendre et garder le cité de leurs ennemis.
Et toutdis se tenoit la contesse de Montfort
au siège de Vennes avoech monsigneur Robert d’Artois.
5 Ossi messires Gautiers de Mauni, qui s’estoit
tenus en Hembon un grant temps, recarga le ditte
ville et le chastiel à monsigneur [Guillaume] de Quadudal
et as deux frères de Pennefort, puis prist
avoech lui monsigneur Yvon de Tigri et cent hommes
10 d’armes et deux cens arciers. Et vinrent en l’ost devant
Vennes, et leur fisent messires Robers d’Artois
et li chevalier d’Engleterre grant feste.
Assés tost apriès que messires Gautiers de Mauni
fu là venus, se fist uns assaus devant Vennes moult
15 grans et moult fors. Et assallirent la cité, cil qui assegiet
l’avoient, en trois lieus et tout à une fois. Et trop
donnèrent à faire à chiaus de dedens, car li archier
d’Engleterre traioient si ouniement et si espessement
c’à painnes s’osoient cil qui deffendoient amoustrer
20 as garittes. Et dura cilz assaulz un jour tout entier.
Si y eut pluiseurs bleciés d’un lès et de l’autre. Quant
ce vint sus le soir, li Englès se retraisent à leurs
logeis, et cil de Vennes as hostelz, tous lassés et moult
travilliet; si se desarmèrent. Mais chil de l’host ne
25 fisent mies ensi; ançois se tinrent en leurs armeures
et ostèrent tant seulement leurs bacinès, et burent
un cop cescuns et se rafreschirent.
Or avint que là presentement et tantost, par l’avis
 de monsigneur Robert d’Artois, qui fu uns grans et
30 sages guerriières, ilz s’ordonnèrent de rechief en
trois batailles, et envoiièrent les deux as portes là où
il faisoit le plus fort assallir, et la tierce fisent tenir
[15] toute quoie couvertement. Et ordonnèrent que, si
tretost comme li aultre aroient assalli une longe espasse,
et que cil de Vennes entenderoient à yaus
deffendre, il se trairoient avant sus ce plus foible lès,
5 et seroient tout pourveu d’eschelles cordées à grawès
de fier, pour jetter sus les dis murs et atachier as garittes,
et assaieroient se par ceste voie il le poroient
jamais conquerre. Tout ensi comme li dis messires
Robers l’ordonna et avisa, il le fisent. Et s’en vint li
10 dis messires Robers en le première bataille assallir et
escarmucier à le baille de le porte, et li contes de
Salebrin ensi à l’autre. Et pour ce qu’il faisoit tart, et
afin ossi que cil de dedens en fuissent plus esbahi, il
alumèrent grans feus, si ques li claretés en respondoit
15 dedens le cité de Vennes. Dont il avint que li
homme de le ville et cil dou chastiel cuidièrent
soubdainnement que leurs maisons ardissent; si criièrent:
«Trahi! Trahi! Armés vous, armés vous!» Jà estoient
li pluiseur retret et couchiet pour yaus reposer, car
20 moult avoient eu grant traveil le jour devant. Si se
levèrent soudainnement et s’en vinrent cescuns qui
mieulz mieulz, sans arroi et sans ordenance, et sans
parler à leurs chapitainnes, celle part où li feus estoit.
Et ossi li signeur, qui en leurs hostelz estoient,
25 s’armoient.
Endementrues que ensi il estoient entouelliet et
empeeciet, li contes de Kenfort, messires Gautiers
de Mauni et leurs routes, qui estoient ordonné pour
l’eschellement, entendirent à faire leur emprise. Et
30 vinrent de ce costé où nulz n’entendoit ne gardoit,
et drecièrent leurs eschelles, et montèrent amont,
les targes sus lors testes, et entrèrent par les dis murs
[16] tout paisievlement en le cité. Ne onques ne s’en
donnèrent garde li François et li Breton qui ens estoient;
si veirent leurs ennemis sus le rue et yaus
assallir devant et derrière. Dont n’i eut si hardit ne
5 si aviset qui ne fust tous esbahis, et tournèrent en
fuites cescuns pour lui sauver. Et cuidièrent encores
de premiers que li meschiés fust plus grans qu’il
n’estoit. Car se il se fuissent retourné et deffendu
de bonne volenté, il euissent bien mis hors les Englès
10 qui entret estoient dedens. Et pour ce que riens
n’en fu fait, perdirent il meschamment leur ville. Et
n’eurent mies li chevalier chapitainne loisir de retraire
ou chastiel, mès montèrent tantost à cheval et
partirent par une posterne et prisent les camps pour
15 yaus sauver, et furent tout cil ewireus qui issir
porent. Toutes fois, li sires de Cliçon, messires Hervis
de Lyon, li sires de Tournemine et li sires de
Lohiac se sauvèrent et une partie de leurs gens. Et
tout cil qui furent trouvet et attaint des Englès furent
20 mort ou pris. Et fu la cité de Vennes toute courue
et robée. Et y entrèrent ens toutes manières de gens,
et meismement la contesse de Montfort dalès monsigneur
Robert d’Artois qui en eut grant joie.

§ 190. Ensi que je vous compte, fu la cité de

25 Vennes à ce temps prise par l’emprise de monsigneur
Robert d’Artois, dont tous li pays d’environ
fu durement esmervilliés. Et en murmurèrent grandement
sus le partie des chevaliers qui dedens estoient
au jour que elle fu prise, comment que je
30 cuide bien que ce fust à grant tort, car il y perdirent
plus que tout li aultre. Et de l’anoi qu’il en eurent,
[17] il le demonstrèrent assés tost apriès, si com vous
orés avant en l’ystore.
Au cinquième jour que la cité de Vennes eut esté
prise, s’en retourna la contesse de Montfort dedens
 5 Hembon, et messires Gautiers de Mauni avoech li, et
messires Yves de Tigri et pluiseur aultre chevalier
d’Engleterre et de Bretagne, pour le doubtance des
rencontres.
Et se partirent encores de monsigneur Robert
10 d’Artois li contes de Sallebrin, li contes de Pennebruch,
li contes de Sufforch et li contes de Cornuaille,
à bien mille hommes d’armes et trois mille arciers,
et s’en vinrent assegier le cité de Rennes. Si s’en
estoient parti, quatre jours devant, messires Charles
15 de Blois et ma dame sa femme et venu à Nante;
mais il avoient laissiet en le cité de Rennes grant
garnison, chevaliers et escuiers a plenté.
Et tout dis se tenoit messires Loeis d’Espagne sus
le mer à tout ses Espagnols et ses Geneuois. Et gardoit
20 si près et si songneusement les frontières d’Engleterre
que nulz ne pooit aler ne venir d’Engleterre
en Bretagne qu’il ne fust en grant peril. Et fist celle
saison as Englès moult de contraires et de damages.

§ 191. Pour le prise et le perte de le cité de Vennes

25 fu li pays durement esmeus et courouciés, car bien
cuidoient que li dessus dit signeur et chapitainne,
qui dedens estoient quant elle fu prise, le deuissent
deffendre et garder un [grant[260]] temps contre tout
le monde, car elle estoit forte assés et bien pourveue
[18] de toute artillerie et d’autres pourveances et bien
garnie de gens d’armes. Si en estoient pour le mesavenue
tout honteus li sires de Cliçon et messires
Hervis de Lyon, car ossi li envieus[261] en parloit
5 villainnement sus leur partie. De quoi li doi seigneur
ne vorrent mies plenté sejourner, ne yaus endormir
en le renommée des mesdisans; ains cueillièrent
grant fuison de bons compagnons, chevaliers et escuiers
de Bretagne, et priièrent à ces chapitainnes
 10 des forterèces qu’il vosissent estre à ce jour, que ordonné
et nommé entre yaus avoient, sus les camps, à
tel quantité de gens qu’il poroient. Tout y obeirent
de grant volenté, et s’esmurent telement toutes manières
de gens de Bretagne qu’il furent sus un jour
15 par devant le cité de Vennes plus de douze mille
hommes, que frans, que villains, et tous armés. Et là
vint bien estoffeement messires Robers de Biaumanoir,
mareschaus de Bretagne. Et assegièrent le cité
de Vennes de tous costés, et puis le commencièrent
20 fortement à assallir.

§ 192. Quant messires Robers d’Artois se vei assegiés

dedens Vennes, si ne fu mies trop esbahis de
lui tenir vassaument et de deffendre le cité. Li Breton,
qui devant estoient comme tout foursenet de
25 chou, che leur sambloit, que perdu l’avoient si simplement,
s’aventuroient à l’assallir durement et corageusement,
et se hastoient d’yaus aventurer, par quoi
cil qui se tenoient devant Rennes et cil qui estoient
ossi dedens Hembon ne leur venissent pour yaus
[19] brisier leur emprise. Dont il avint que li Breton qui
là seoient fisent et livrèrent à le ditte cité un assaut
si dur et si bien ordonné, et si corageusement s’i
esprouvèrent li assallant, chevalier et escuier, et
5 meismement li bon homme dou pays, et tant donnèrent
à faire à chiaus de dedens, qu’il conquisent les bailles
dou bourch et puis les portes de le cité. Et entrèrent
ens par force et par proèce, vosissent ou non li
Englès, et furent mis en cace; et moult en y eut adonc
10 grant fuison de mors et de navrés. Et par especial
messires Robers d’Artois y fu durement navrés; et à
grant mescief fu il sauvés et gardés d’estre pris. Et se
parti par une posterne derrière, et messires Richars
de Stanfort avoecques lui, et cil qui escaper peurent;
15 et chevaucièrent devers Hembon. Et là fu pris et
 fianciés prisons de monsigneur Hervi de Lyon li sires
Despensiers d’Engleterre, filz à monsigneur Huon le
Despensier de jadis, dont cilz livres fait mention ens
ou commencement; mais il fu si dur blechiés à cel
20 assaut qu’il ne vesqui depuis que trois jours.
Ensi eurent li François et reconquisent le ville et
le cité de Vennes, et misent hors tous leurs ennemis
par sens et par proèce. De quoi li signeur d’Engleterre,
qui seoient devant Rennes, furent durement
25 courouciet. Et ossi fu la contesse de Montfort, qui se
tenoit en Hembon; mais amender ne le peut, tant
c’à celle fois. Si demora messires Robers d’Artois un
temps bleciés et navrés, si com vous avés oy. En le
fin, il li fu consilliet et dit, pour le mieulz mediciner
30 et garir, qu’il s’en repairast en Engleterre, car là
trouveroit il surgiiens et medecins à volenté. Si crut
ce conseil, dont il fist folie; car au retourner en
[20] Engleterre il fu durement grevés et appressés de le
marée. Et s’en esmurent telement ses plaies que,
quant il fu venus et aportés à Londres, il ne vesqui
point longuement depuis; ançois moru de ceste maladie:
5 dont ce fu damages, car il estoit courtois chevaliers,
preus et hardis, et dou plus noble sanch dou
monde. Si fu ensepelis à Saint Pol à Londres. Et li
fist li rois englès faire son obsèque ossi solennelment
comme c’euist esté pour son cousin germain le conte
10 Derbi. Et fu li dis messires Robers moult durement
plains dou roy, de ma dame la royne, des signeurs
et des dames d’Engleterre.
Si tretost que messires Robers d’Artois fu trespassés
de ce siècle, et que li rois englès en seut les nouvelles,
15 il en fu si courouciés qu’il jura et dist, oiant
tous chiaus qui oïr le porent, que jamais n’entenderoit
à aultre cose si aroit vengiet le mort de lui, et
iroit meismement en Bretagne, et atourroit tel le pays
que dedens quarante ans apriès il ne seroit point
 20 recouvret. Si fist li rois englès tantost escrire lettres
et mander par tout son royaume, que cescuns, nobles
et non nobles, fust appareilliés pour mouvoir
avoecques lui au chief dou mois. Et fist faire tantos
grant amas de naves et de vaissiaus, et bien pourveir
25 et estofer de ce qu’il apertenoit. Au chief dou mois,
il se mist en mer à grant pourveance de navie et de
gens d’armes, et vint prendre port assés priès de
Vennes, là où messires Robers d’Artois et se compagnie
arrivèrent, quant il vinrent en Bretagne. Si descendirent
30 à terre, et misent par trois jours hors leurs
chevaus et leurs pourveances. Et puis au quatrime
jour, il chevaucièrent par devers Vennes. Et toutdis
[21] se tenoit li sièges dou conte de Salebrin et dou conte
de Pennebruch et des Englès dessus dis, devant
Rennes.

§ 193. Tant esploita li rois englès, depuis qu’il

5 eut pris terre en Bretagne, qu’il vint à toute son
host par devant le cité de Vennes, et le assega de tous
poins. A ce donc estoient dedens messires Oliviers
de Cliçon, messires Hervis de Lyon, li sires de Tournemine,
messires Joffrois de Malatrait et messires
10 Guis de Lohiac. Si pensoient bien cil chevalier et
avoient supposé de lonch temps que li rois englès
venroit moult efforciement en Bretagne, si comme il
fist. Pour quoi il avoient le cité et le chastiel de
Vennes pourveu très grossement de toutes pourveances
15 necessaires, et ossi de bonnes gens d’armes
pour le deffendre. Et bien leur besongnoit, car si
tost que li rois englès fu venus et logiés par devant,
il les fist assallir moult asprement, et venir les arciers
par devant et traire de grant randon à chiaus de le
20 cité très fortement. Et dura cilz assaus bien demi
jour, mais riens n’i fisent fors yaus lasser et travillier,
tant fu la cité bien deffendue. Adonc se retraisent li
 Englès en leurs logeis. Si tost que la contesse de
Montfort sceut la venue dou roy englès, elle fu
25 moult resjoye et se parti de Hembon, acompagnie
de monsigneur Gautier de Mauni et de pluiseurs
aultres chevaliers et escuiers; [et s’en vint devant
Vennes[262]] conjoïr et festiier le roy d’Engleterre et les
[22] barons de l’host. Li rois recueilla la dame moult
liement, et adonc eut entre yaus là pluiseurs parolles
qui toutes ne poeent mies estre escrites. Et quant la
contesse ot là esté devant Vennes avoech le roy ne
5 sçai trois jours ou quatre, elle s’en parti et retourna
en Hembon avoecques ses gens.
Or vous parlerons de monsigneur Charlon de Blois
qui se tenoit dedens le cité de Nantes. Si tost qu’il
sceut que li rois englès estoit arrivés en Bretagne, il
10 le segnefia au roy de France son oncle, et y envoia
devers lui grans messages de Bretagne, pour mieulz
esploitier et pour priier qu’il fust aidiés et confortés
à l’encontre des Englès, car il estoient venu en son
pays à grant poissance. Li rois oy et reçut les messages
15 moult liement, et en respondi courtoisement, et
dist qu’il envoieroit à son neveut si grant confort
que pour bien resister contre ses ennemis, et yaus
bouter hors de Bretagne. Voirement y envoia il depuis
le duch de Normendie son fil à grant poissance,
20 mais ce ne fu mies si tretost. Ançois eurent li Englès
moult adamagiet et destruit le bon pays de Bretagne,
si com vous orés avant en l’ystore.

§ 194. Quant li rois englès, qui seoit devant

Vennes, vit la cité si forte et si bien furnie de gens
25 d’armes, et entendi par ses gens que li pays de là
environ estoit si povres et si gastés qu’il ne savoient
où fourer ne avoir vivres pour yaus ne pour leurs
chevaus, tant estoient il grant nombre, si s’avisa qu’il
en lairoit là une partie pour tenir le siège, et à tout
 30 le remanant de son host il se trairoit devant Rennes,
et veroit ses gens qui là seoient, qu’il n’avoit veus
[23] de grant temps. Si ordonna le conte de Warvich, le
conte d’Arondel, le baron de Stanfort, monsigneur
Gautier de Mauni, monsigneur Yvon de Tigri et les
deux frères de Pennefort, à cinq cens hommes d’armes
5 et mille arciers, à tenir le siège devant Vennes.
Puis s’en parti li rois à tout le remanant de son
host, où bien avoit quinze cens hommes d’armes et
six mille arciers. Et chevauça tout ardant et essillant
le pays d’un lès et d’autre, et fist tant qu’il vint
10 devant Rennes, où il fu moult liement veus et receus
de ses gens qui là seoient et avoient sis un grant
temps. Et quant il ot là esté environ cinq jours, il
entendi que messires Charles de Blois estoit dedens
la cité de Nantes et faisoit là son amas de gens d’armes;
15 si dist qu’il se trairoit celle part.
Et se parti dou siège de Rennes, et y laissa chiaus
que trouvés y avoit; et chevauça tant qu’il parvint à
toute son host devant Nantes: si l’assega si avant
qu’il peut, car toute environner ne le peuist mies,
20 tant est grande et estendue. Si coururent li mareschal
et ses gens environ, et gastèrent et essillièrent durement
le plat pays; et prendoient vivres et pourveances
par tout où il les pooient avoir. Et furent li
rois d’Engleterre et toutes ses gens ordonné sus une
25 montagne au dehors de le cité de Nantes un jour,
dou matin jusques à nonne, par manière de bataille.
Et cuidoient bien li Englès que messires Charles de
Blois et ses gens deuissent issir, mès non fisent.
Quant li Englès veirent ce, si se retraisent à leur
30 logeis; mès li coureur le roy d’Engleterre coururent
adonc jusques as barrières de le cité, et à leur retour
il ardirent les fourbours.
[24] § 195. Ensi se tint li rois d’Engleterre par devant
Nantes. Et messires Charles de Blois estoit dedens,
qui souvent escrisoit et envoioit lettres et messages
et l’estat des Englès, devers le roy de France, son
5 oncle, et le duch de Normendie, son cousin, qui le
devoit conforter, car il en estoit cargiés. Et estoit jà
trais et venus li dus de Normendie en le cité d’Angiers,
et là faisoit son amas de toutes manières de
gens d’armes qui li venoient de tous costés. Entrues
10 que ces assemblées se faisoient, se tenoit li rois d’Engleterre
devant Nantes, et le avoit assegie à l’un des
costés, et y faisoit souvent assallir et escarmucier et
esprouver ses gens. Mès en tous assaus petit y conquist;
ançois y perdi par pluiseurs fois de ses hommes,
15 dont moult li anoia.
Quant il vei et considera que par assaut il n’i pooit
riens faire, et que messires Charles de Blois n’isteroit
point as camps pour lui combatre, si s’avisa qu’il
lairoit là le plus grant partie de ses gens à siège, et se
20 trairoit aultre part tout dis, en gastant et essillant le
pays. Si ordonna le conte de Kenfort, monsigneur
Henri visconte de Byaumont, le signeur de Persi, le
signeur de Ros, le signeur de Montbrai, le signeur de
le Ware, monsigneur Renault de Gobehen et monsigneur
25 Jehan de Lille à là demorer et tenir le siège
à six cens armeures de fier et deux mille arciers; et
puis si chevauça o le demorant de ses gens. Si
pooient estre environ quatre cens lances et deux
mille arciers, tout ardant et essillant le bon pays de
30 Bretagne par devant lui, de l’un lès et d’autre, tant
qu’il vinrent devant le bonne ville de Dignant dont
messires Pières Portebuef estoit chapitainne. Quant
[25] il parfu venus devant Dignant, il mist le siège tout
environ, et le fist fortement assallir. Et cil qui dedens
estoient entendirent ossi à yaus deffendre. Ensi assega
li rois d’Engleterre tout en une saison, et en un
 5 jour, [luy et[263]] ses gens, trois cités en Bretagne et une
bonne ville.

§ 196. Entrues que li rois d’Engleterre aloit et

venoit et chevauçoit le pays de Bretagne, ses gens
qui seoient devant le cité de Vennes y faisoient et
10 livroient tous les jours tamaint assaut, car durement
le convoitoient à gaegnier par fait d’armes, pour
tant que li chevalier qui dedens estoient l’avoient
reconquis sus yaus en celle meisme saison. Dont il
avint un jour, le siège pendant, que, à l’une des
15 portes, uns très grans assaus se fist. Et se traisent de
celle part toutes les bonnes gens d’armes, de l’un
costé et de l’autre. Et là eut tamainte belle apertise
d’armes fait. Car cil dedens Vennes avoient, comme
bon chevalier et hardi, ouvert leur porte et se tenoient
20 à le barrière, pour le cause de ce qu’il
veoient le banière le conte de Warvich et ceste dou
conte d’Arondiel et dou baron de Stanfort et de
monsigneur Gautier de Mauni qui s’abandonnoient,
ce leur sambloit, assés folement. De quoi li sires de
25 Cliçon et messires Hervis de Lyon et li aultre chevalier
plus corageusement s’en aventuroient. Là y eut
fait tant de belles apertises d’armes que merveilles
seroit à recorder. Car li Englès, qui veoient le porte
ouverte, le tenoient en grant despit, et li aucun le
[26] reputoient à vaillance. Là eut lanciet et estechiet d’un
lès et de l’autre moult longement. Finablement, cilz
assaus se porta telement que [de premiers[264]] li Englès
furent reboutet et reculet moult arrière des barrières.
5 Et à ce qu’il reculèrent, li chevalier de Bretagne s’avancièrent
et ouvrirent leur baille, cescuns son glave en
son poing, et laissièrent six chevaliers des leurs pour
garder le baille, avoec grant fuison d’autres gens. Et
puis tout à piet, en lançant et escarmuchant, il
10 poursievirent les chevaliers englès qui tout en reculant
 se combatoient. Là eut très bon puigneis et fort
bouteis de glaves, et mainte belle apertise d’armes
faite. Toutefois, li Englès montepliièrent et fortefiièrent
telement qu’il couvint les Bretons reculer, et
15 non pas si rieuleement qu’il estoient avalet. Là eut
grant luite et dur encauch. Et remontoient li chevalier
de Bretagne, li sires de Cliçon et messires Hervis
de Lyon, à grant malaise. Si y eut maint homme mort
et blecié. Quant cil qui gardoient le barrière veirent
20 leurs gens cacier et reculer, il retraisent leurs bailles
avant, et si mal à point qu’il couvint le signeur de
Cliçon demorer dehors, [et fu pris devant le barrière;
et ossi fu messires Hervis de Lion[265]]. D’autre part, li
Englès qui estoient monté vistement, et tous premiers
25 li barons de Stanfort, furent enclos et se
banière entre les bailles et le porte. Là eut grant
touellement et dur hustin. Et fu pris et retenus li
sires de Stanfort, onques nulz ne l’en peut aidier; et
ossi furent pluiseur des siens qui estoient dalès lui:
[27] [Oncques[266]] nulz n’en escapa qu’il ne fuissent ou mort
ou pris. Si se departi ceste estourmie atant, et se
retraisent li Englès à leurs logeis, et li [Breton[267]] à
leurs hostelz par dedens le cité de Vennes.

5 § 197. Par tel manière que vous avés oy compter

furent pris li chevalier dessus nommé. Et euissent fait
li Englès grant feste de leurs prisonniers, se li sires
de Stanfort n’euist esté pris. Depuis cest assaut, n’en
y eut [fait[268]] nul si grant ne si renommé d’armes que
10 cilz fu, car cescuns se tenoit sus se garde. Or parlerons
dou roy d’Engleterre qui avoit assegiet le ville
de Dinant. Quant il eut là sis jusques à trois jours là
en dedens, il avisa et ymagina comment il le poroit
avoir. Si regarda que elle estoit bien prendable,
15 car elle n’estoit fremée fors que de palis. Si fist
querre et pourveir grant fuison de nacelles, et entrer
 dedens arciers, et puis nagier jusques à ces palis, et
yaus venu jusques à là, assallir fortement à ceulz qui
les deffendoient, et traire si ouniement que à painnes
20 osoit nuls apparoir as deffenses pour le deffendre.
Entre ces arciers y avoit autres assallans qui portoient
cuignies grandes et bien trençans, dont, entrues
que li arcier ensonnioient chiaus de dedens, il copoient
les palis; et les eurent en brief temps grandement
25 adamagiés, et tant qu’il en gettèrent un grant
pan par terre, et entrèrent ens efforciement. Quant
cil de le ville veirent leurs palis rompus et Englès
entrer ens à grant randon, si furent tout effraet. Et
[28] commencièrent à fuir vers le marchiet: mais petite
ralloiance se fist entre yaus, car cil qui estoient entré
ens par les nacelles vinrent à le porte et l’ouvrirent.
Si entrèrent ens toutes manières d’autres gens qui
5 entrer y vorrent. Ensi fu prise li ville de Dinant en
Bretagne, toute courue et robée, et messires Pières
Portebuef qui capitainne en estoit. Si prisent li Englès
des quelz qu’il veirent[269], et gaegnièrent grant
avoir dedens, car elle estoit adonc durement riche
10 et plainne et bien marchande.

§ 198. Quant li rois d’Engleterre eut fait sen emprise

et sa volenté de le ville de Dinant en Bretagne,
il s’en parti, et le laissa toute vaghe, et n’eut mies
conseil dou tenir; si s’en achemina vers Vennes. En
15 chevauçant celle part, les nouvelles li vinrent de le
prise le signeur de Cliçon et de monsigneur Hervi de
Lyon. Si en fu grandement joians, et tant chevauça
qu’il vint devant Vennes, et là se loga.
Or vous parlerons un petit de monsigneur Loeis
20 d’Espagne, de messire Charle Grimau, de monsigneur
Othon Doriie, qui estoient pour le temps amiral de
le mer, à huit galées, treize barges et trente nefs cargies
de Geneuois et d’Espagnols. Si se tenoient sus