Te chnical Note #5181 Versio n : Acrobat 6

1 Acrobat Forms API. bc Reference Technical Note # 5181 . Version : Acrobat ADOBE SYSTEMS INCORPORATED. Corporate Headquarters 345 Park Avenue San Jose, CA 95110-2704. (408) 536-6000. May 2003. 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.

2 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.

3 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.

4 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.

5 Acrobat SDK Documentation Roadmap Getting Started Getting Started Using the Acrobat Software Development Kit PDF Specification Acrobat SDK Release notes Acrobat Developer FAQ Reader Enabling PDF Reference Acrobat Development Overview Acrobat Plug-in Tutorial Acrobat SDK Samples Guide Manual Upgrading Plug-ins from Acrobat to Acrobat Acrobat Core API Extended API for Plug-in PDF Creation APIs JavaScript Acrobat Interapplication and Specifications Communication (IAC). Acrobat Core Acrobat JavaScript API Overview AcroColor API Reference Acrobat Distiller Scripting Acrobat IAC Overview Parameters Reference Acrobat Core Acrobat IAC Reference API Reference ADM Programmer's Acrobat Distiller Acrobat Guide and Reference API Reference JavaScript Scripting Guide pdfmark Catalog API Reference Reference Programming Acrobat JavaScript Using Visual Basic Digital Signature API.

6 Reference Forms API Reference PDF Consultant Accessibility Checker Search API Reference Spelling API Reference Using the Save as XML Plug-in Weblink API Reference 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.

7 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. Acrobat Forms API Reference 5. Contents AFPDDocLoadPDFields .. 31. AFPDF ieldFromCosObj .. 32. AFPDF ieldGetCosObj .. 33. AFPDF ieldGetDefaultTextAppearance .. 34. AFPDF ieldGetFlags.

8 35. AFPDF ieldGetName .. 36. AFPDF ieldGetValue .. 37. AFPDF ieldIsAnnot .. 38. AFPDF ieldIsTerminal.. 39. AFPDF ieldIsValid .. 40. AFPDF ieldReset .. 41. AFPDF ieldSetDefaultTextAppearance.. 42. AFPDF ieldSetFlags .. 43. AFPDF ieldSetOptions .. 44. AFPDF ieldSetValue.. 45. AFPDFormFromPage .. 46. AFPDW idgetGetAreaColors .. 47. AFPDW idgetGetBorder .. 48. AFPDW idgetGetRotation .. 49. AFPDW idgetSetAreaColors.. 50. AFPDW idgetSetBorder .. 51. AssembleFormAndImportFDF.. 52. ExportAsFDF .. 53. ExportAsFDFEx.

9 55. ExportAsFDFWithParams .. 57. ExportAsHtml .. 58. ExportAsHtmlEx.. 59. ImportAnFDF .. 61. IsPDDocAcroForm .. 62. ResetForm .. 63. AcroForm Callbacks .. 65. AFPDF ieldEnumProc.. 65. AcroForm Declarations .. 67. AcroForm Data Types .. 67. AF_Flags_t .. 67. AFPDF ieldBorder .. 69. AFPDF ieldFlags_t .. 70. AFPDW idgetBorder .. 71. AFPDW idgetBorderRec .. 71. AFPDW idgetBorderStyle .. 72. ExportAsFDFP arams .. 73. ExportAsFDFP aramsRec.. 73. 6 Acrobat Forms API Reference Contents RetCode.. 76. TextAppearance.

10 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. AFTTSP ause .. 95. AFTTSQS ilence .. 96. AFTTSQS ound .. 97. AFTTSQ ueueTextData.