[PDF] [PDF] Acrobat Forms API Reference - Adobe Experience League

[PDF] Acrobat DC - Adobe Help Center

Adobe is testing the compress or reduce multiple PDF files experience fields Use the Edit tool to edit text, images, or form fields from within the format options, such as line spacing, character spacing, horizontal scaling, stroke width, and color 7 To move the text box, place the pointer over the line of the bounding box 

[PDF] Acrobat Forms API Reference - Adobe Experience League

act as a form; that is, the Acrobat equivalent of a paper form with fields If true, the text can use multiple lines in a text field The spacing between words

[PDF] ADOBE® ACROBAT® READER DC - Adobe Help Center

Use Comb fields to fill or add text in continuous boxes in a line/row While you are typing, if the characters do not fit in each box, adjust the spacing with the grab handle where the Open the PDF document or form that you want to sign Only Acrobat DC users with multi-byte versions of Acrobat DC can start an approval 

[PDF] PDF Reference, Third Edition - Adobe

All instances of the name PostScript in the text are references to the PostScript language as defined Entries in a form field's additional-actions dictionary 516 8 33 across multiple lines by using the backslash character at the end of a line to indi- image's height is not predetermined, and the encoded data must be

[PDF] Designing forms for auto field detection in Adobe - Acrobat Users

Adobe Acrobat software (versions 8 and 9) has the ability to recognize form fields , making it faster and such as horizontal and vertical lines and stroked rectangles, are also analyzed in Do not use the same text label across multiple fields Watch point sizes in your designs; the text field height is A multiline text field 

[PDF] Comprehensive Word-to-PDF and PDF Accessibility Guide

it to PDF, use the PDF Remediation in Adobe Acrobat Pro Checklist empty lines of text (i e , empty Multiple accessibility checks Forms Does the PDF include form fields? Item #3 Proper Paragraph Spacing < Start in Word Checklist 

[PDF] Working with Adobe Acrobat Pro DC Overview Integration with

Any document, even a plain text document can be converted to PDF 2 You can as line spacing, character spacing, horizontal scaling, stroke width, If the form contains multiple check boxes, the user can typically select as many or few of

[PDF] Editing Text in PDF Documents

color scale, baseline shift, tracking, word spacing, and line alignment Acrobat offers the following features for touching up text: • Ctrl-click (Windows) or The Embed check box allows you to quickly remove embedding from any embedded

[PDF] Prepare Form - Colorado State University

Acrobat is usually really good with finding text fields, but radio buttons, check boxes, Tip: To move the field without resizing it, check the Do not change height and width enter in multiple lines of text, the Multi-line option must be selected

[PDF] Adobe Acrobat DC Guide - Nemsys

Adobe Acrobat DC: A Complete Overview For Connect Users Nemsys LLC Move, rotate, or resize a text box Measure the height, width, or area of objects Alternatively, you can use a drawing tool to add a line, circle, or other shape and then type a Step 2: Select single file or multiple files for office documents

[PDF] adobe pdf form multiline text field

[PDF] adobe pdf javascript

[PDF] adobe pdf javascript editor

[PDF] adobe pdf javascript examples

[PDF] adobe pdf javascript functions

[PDF] adobe pdf library sdk examples

[PDF] adobe pdf markup

[PDF] adobe pdf reference

[PDF] adobe pdf security block

[PDF] adobe pdf security envelope

[PDF] adobe pdf security settings

[PDF] adobe personalization

[PDF] adobe personalization solution

[PDF] adobe photo cloud storage review

[PDF] adobe photoshop

ADOBE SYSTEMS INCORPORATED

Corporate Headquarters

345 Park Avenue

San Jose, CA 95110-2704

(408) 536-6000 http://partners.adobe.com bbc

May 2003

Technical Note #5181

Version : Acrobat 6.0

Acrobat Forms API

Reference

Copyright 2003 Adobe Systems Incorporated. All rights reserved.

NOTICE: All information contained herein is the property of Adobe Systems Incorporated. No part of this publication (whether in hardcopy or

electronic form) may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or

otherwise, without the prior written consent of the Adobe Systems Incorporated.

PostScript is a registered trademark of Adobe Systems Incorporated. All instances of the name PostScript in the text are references to the

PostScript language as defined by Adobe Systems Incorporated unless otherwise stated. The name PostScript also is used as a product

trademark for Adobe Systems" implementation of the PostScript language interpreter.

Except as otherwise stated, any reference to a

PostScript printing device,"

PostScript display device," or similar item refers to a printing

device, display device or item (respectively) that contains PostScript technology created or licensed by Adobe Systems Incorporated and not

to devices or items that purport to be merely compatible with the PostScript language.

Adobe, the Adobe logo, Acrobat, the Acrobat logo, Acrobat Capture, Distiller, PostScript, the PostScript logo and Reader are either registered

trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Apple, Macintosh, and Power Macintosh are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC

is a registered trademark of IBM Corporation in the United States. ActiveX, Microsoft, Windows, and Windows NT are either registered

trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. UNIX is a registered trademark of The Open

Group. All other trademarks are the property of their respective owners.

This publication and the information herein is furnished AS IS, is subject to change without notice, and should not be construed as a

commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies,

makes no warranty of any kind (express, implied, or statutory) with respect to this publication, and expressly disclaims any and all warranties

of merchantability, fitness for particular purposes, and noninfringement of third party rights.

Acrobat Developer FAQ

PDF Creation APIs

and SpecificationsAcrobat Interapplication

Communication (IAC)

Acrobat Core API Extended API for Plug-in

Acrobat Core

API Reference

Acrobat Distiller

Parameters

Acrobat Distiller

API Reference

pdfmark

Reference

Digital Signature API

Reference

Forms API Reference

Search API Reference

Weblink API ReferenceAcrobat SDK Release Notes

Catalog API Reference

Acrobat SDK Samples Guide

Acrobat Core

API Overview

Acrobat Plug-in Tutorial

Acrobat IAC Overview

Acrobat IAC Reference

ADM Programmers

Guide and ReferenceGetting Started Using the Acrobat Software Development Kit

Using the Save as

XML Plug-in

Spelling API Reference

Acrobat SDK Documentation Roadmap

AcroColor API Reference

Acrobat Development Overview

PDF Consultant

Accessibility Checker

PDF Reference

Manual

JavaScript

Acrobat JavaScript

Scripting

Reference

Acrobat

JavaScript

Scripting Guide

Programming

Acrobat JavaScript

Using Visual Basic

Upgrading Plug-ins from Acrobat 5.0 to Acrobat 6.0

Reader Enabling

PDF Specification

Getting Started

Acrobat Forms API Reference

5

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

What Is In This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Other Useful Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Conventions Used in This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

AcroForm API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

AcroForm Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

AcroForm Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

PDField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Core Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

ASAtom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

ASBool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

ASFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

ASPathName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

AVDoc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

CosDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

CosObj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

PDAnnot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

PDDoc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

PDPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

AcroForm Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

AFExecuteThisScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

AFImportAppearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

AFLayoutBorder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

AFLayoutCreateStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

AFLayoutDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

AFLayoutNew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

AFLayoutText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

AFPDDocEnumPDFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

AFPDDocGetPDFieldFromName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Contents

6

Acrobat Forms API Reference

AFPDDocLoadPDFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

AFPDFieldFromCosObj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

AFPDFieldGetCosObj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

AFPDFieldGetDefaultTextAppearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

AFPDFieldGetFlags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

AFPDFieldGetName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

AFPDFieldGetValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

AFPDFieldIsAnnot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

AFPDFieldIsTerminal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

AFPDFieldIsValid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

AFPDFieldReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

AFPDFieldSetDefaultTextAppearance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

AFPDFieldSetFlags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

AFPDFieldSetOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

AFPDFieldSetValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

AFPDFormFromPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

AFPDWidgetGetAreaColors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

AFPDWidgetGetBorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

AFPDWidgetGetRotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

AFPDWidgetSetAreaColors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

AFPDWidgetSetBorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

AssembleFormAndImportFDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

ExportAsFDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

ExportAsFDFEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

ExportAsFDFWithParams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

ExportAsHtml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

ExportAsHtmlEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

ImportAnFDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

IsPDDocAcroForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

ResetForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

AcroForm Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65

AFPDFieldEnumProc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

AcroForm Declarations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

AcroForm Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

AF_Flags_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

AFPDFieldBorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

AFPDFieldFlags_t. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

AFPDWidgetBorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

AFPDWidgetBorderRec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

AFPDWidgetBorderStyle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

ExportAsFDFParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

ExportAsFDFParamsRec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Acrobat Forms API Reference

7

Contents

RetCode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

TextAppearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

TextAppearanceP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Core Data Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

PDColorSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

PDColorValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

PDColorValueRec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

PDRotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

AcroForm Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83

Init_TextAppearanceP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

SetDefaultTextAppearanceP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

TextApperanceIsValid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Text-to-Speech API (Windows only) . . . . . . . . . . . . . . . . . . . . . . . . .87

AFTTSGetNumberOfVoices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

AFTTSGetPitch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

AFTTSGetSpeaker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

AFTTSGetSpeechRate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

AFTTSGetVoiceName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

AFTTSGetVolume. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

AFTTSIsAvailable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

AFTTSPause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

AFTTSQSilence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

AFTTSQSound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

AFTTSQueueTextData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

AFTTSReset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

AFTTSResume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100

AFTTSSetPitch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

AFTTSSetSpeaker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

AFTTSSetSpeechRate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

AFTTSSetVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104

AFTTSStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

AFTTSTalk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

AcroForm OLE Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Contents

8

Acrobat Forms API Reference

OLE Automation Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

AFormApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

OLE Automation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

PopulateListOrComboBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

SetBackgroundColor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

SetBorderColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113

SetButtonCaption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114

SetButtonIcon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115

SetExportValues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116

SetForegroundColor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

SetJavaScriptAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118

SetResetFormAction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121

SetSubmitFormAction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123

Add. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123

AddDocJavascript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

ExecuteThisJavascript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

ExportAsFDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

ExportAsHtml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128

ImportAnFDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129

Remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

OLE Automation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

BorderStyle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132

BorderWidth. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133

ButtonLayout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

CalcOrderIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135

CharLimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136

DefaultValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137

Editable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138

Highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139

IsHidden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140

IsMultiline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141

IsPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142

IsReadOnly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143

IsRequired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144

IsTerminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145

Acrobat Forms API Reference

9

Contents

Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

NoViewFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147

PrintFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149

TextFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150

TextSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151

Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152

Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153

Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154

Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154

Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155

_NewEnum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156

Contents

10

Acrobat Forms API Reference

Acrobat Forms API Reference

11

Preface

The Adobe

Acrobat

Forms plug-in allows a Portable Document Format (PDF) document to act as a form; that is, the Acrobat equivalent of a paper form with fields. It is now faster and easier to exchange information either in familiar paper or electronic forms converted to PDF files with Acrobat, or as dynamic interactive database templates. N OTE

Forms as used here do not refer to

XObject

forms as defined in the

PDF Reference.

The Forms plug-in for Acrobat (versions 4.0 and above) allows users to author form fields. For Acrobat Reader, the Forms plug-in does not allow form authoring, but allows users to fill in data and print Acrobat forms. The Reader Forms plug-in also does not allow users to save data to the local hard disk. Both Acrobat and Reader allow Web designers to send data from the form back to a Web server.

What Is In This Document

This document is a reference for developers who want to take advantage of the Forms API.

It is divided into two sections:

AcroForm API Reference

describes the Forms API and explains how to use it. It includes the new Text-to-Speech APIs for Windows.

AcroForm OLE Automation

describes the OLE Automation methods exported by the

Adobe Acrobat AcroForm plug-in.

If you received this technical note without obtaining the entire Acrobat Software Development Kit (SDK), you can get the complete SDK by visiting: h ttp://partners.adobe.com/asn/developer/acrosdk/main.html.Other Useful

Documentation

Other Useful Documentation

You should be familiar with the Acrobat core API. The following technical notes provide this information.

Acrobat Core API Overview,

technical note 5190,gives an overview of the objects and methods provided by the Acrobat core API.

Acrobat Core API Reference,

technical note 5191,describes in detail the objects and methods provided by the Acrobat core API.

Acrobat Development Overview

, technical note 5167, describes how to develop Acrobat plug-ins on the various platforms available.

Preface

Conventions Used in This Book

12

Acrobat Forms API Reference

PDF Reference,

Fourth Edition, version 1.5. Provides a description of the PDF file format, as well as suggestions for producing efficient PDF files.

Conventions Used in This Book

The Acrobat documentation uses text styles according to the following conventions.

FontUsed for Examples

monospaced Paths and filenames

C:\templates\mytmpl.fm

Code examples set off

from plain textThese are variable declarations:

AVMenu commandMenu,helpMenu;

monospaced bold Code items within plain textThe

GetExtensionID

method ...

Parameter names and

literal values in reference documentsThe enumeration terminates if proc returns false monospaced italic Pseudocode

ACCB1 void ACCB2 ExeProc(void)

do something

Placeholders in code

examples

AFSimple_Calculate(

cFunction cFields blue Live links to Web pages The Acrobat Solutions Network URL is: h ttp://partners/adobe.com/asn/

Live links to sections

within this documentSee Using the SDK.

Live links to other

Acrobat SDK documentsSee the

Acrobat Core API Overview

Live links to code items

within this documentTest whether an

ASAtom

exists. bold PostScript language and

PDF operators,

keywords, dictionary key namesThe setpagedevice operator

User interface names The

File menu

Acrobat Forms API Reference

13

Preface

Conventions Used in This Book

italic Document titles that are not live links

Acrobat Core API Overview

New terms

User space

specifies coordinates for...

PostScript variables

filename deletefile

FontUsed for Examples

Preface

Conventions Used in This Book

14

Acrobat Forms API Reference

Acrobat Forms API Reference

15

AcroForm API Reference

Introduction

The Acrobat Forms plug-in exports its own Host Function Table (HFT), whose methods can be used by other plug-ins. To use the Acrobat Forms plug-in"s HFT, a plug-in must: include the header file

FormsHFT.h

(which includes

AF_ExpT.h

and

AF_Sel.h)

import the HFT using

ASExtensionMgrGetHFT

. A convenient way to do this is to use the

Init_AcroFormHFT

macro defined in

FORMSHFT.H

#define Init_AcroFormHFT

AcroFormHFT_LATEST_VERSION)

?assign the HFT returned by this call to a plug-in-defined global variable named gAcroFormHFT. Data may be imported and exported into Acrobat Forms in Forms Data Format (FDF). FDF is used to submit form data to a server, as well as to receive the response and incorporate it into a form. FDF is based on PDF and uses the same syntax and set of basic object types as PDF. It also has the same file structure, except that the cross-reference table is optional. See the PDF Reference (Version 1.5, Fourth Edition), Section 8.6.6, for more information.

Contents

This reference contains the following:

?AcroForm Objects introduces AcroForm-specific API objects and briefly describes Core objects that are extensively used in the AcroForm API. ?AcroForm Methods describes in detail all AcroForm methods, including their parameters, return value, and related methods. ?AcroForm Callbacks describes in detail the callback functions. ?AcroForm Declarations describes in detail the data structures used by the Acrobat

Forms plug-in.

?AcroForm Macros describes in detail the macros available for use by developers. ?Text-to-Speech API (Windows only) describes in detail all methods in the Text-to-Speech API.

AcroForm API Reference

Exceptions

16Acrobat Forms API Reference

Exceptions

All AcroForm methods may return an exception. Possible exceptions are:

Exception Name Description

gAFpdErrExportFdf Error during export of FDF document. gAFpdErrBadFdf Invalid FDF document. gAFfileErrSubmitFdf Error opening URL to submit this form. gAFpdErrReqdFld Required field found empty during export of FDF document.

Acrobat Forms API Reference17

AcroForm Objects

AcroForm Objects

The PDField object is introduced in the Forms API.

PDField

A PDField is an opaque object representing a field in an Acrobat form. A PDF document that contains forms has an AcroForm entry in the document catalog dictionary, which contains an array of references to each of the root fields in the document. The three most important properties of a field are its type, name, and value. Other properties specify the appearance of a field. Fields can be organized into a hierarchy, and other field properties associate it with its parent and children.

There is a field dictionary for every

PDField. Acrobat uses annotations to represent a

field"s appearance and to manage user interactions. A

PDField dictionary may also be an

annotation, in which case its subtype is

Widget. There is no ambiguity, because the keys

of annotations andquotesdbs_dbs14.pdfusesText_20