User manual ADOBE ACROBAT 7.0.5 SDK

[. . . ] ® Acrobat® 7. 0. 5 Adobe Acrobat SDK User's Guide July 27, 2005 Adobe Solutions Network -- http://partners. adobe. com © 2005 Adobe Systems Incorporated. Acrobat® SDK User's Guide If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. [. . . ] They can also use fonts that are already embedded in a PDF document for preview and printing, as well as editing. However, allowing editing using embedded fonts is not recommended, and in some cases it is impractical. For example, CJK fonts potentially include thousands of glyphs, so applications must subset these fonts when embedding them in a PDF file. This precludes embedded CJK fonts from being used for editing by a plug-in. PDF Library users can perform all of the above operations using an existing PDF document, or create a PDF document from scratch that includes embedded fonts. Creating a document from scratch cannot be performed by a plug-in, but it can be done by using PDF library calls from within a compiled application that includes the PDF Library. Acrobat SDK User's Guide 57 5 Working with PDF Documents Large Page Sizes in PDF Documents Large Page Sizes in PDF Documents In previous versions of Acrobat, the maximum size of a PDF document was 200 by 200 inches due to the internal use of ASFixed variables for all coordinates. In Acrobat 7, pages in a PDF document now have a scaling factor associated with them that allows the same number of ASFixed points to represent feet, yards, meters, hectares or other measurements. The value of this scaling factor is per page and can be retrieved in a plug-in using the PDPageGetUserUnitSize API. There are no Acrobat JavaScript APIs to access the unit size information. Wire f ra m e D raw i n g In order to improve the speed of drawing large and complex documents, Acrobat has a new mode that only draws the strokes of objects as simple, one-unit lines as seen in the figure below. It does not affect filled shapes or text. You can get and set wireframe mode from a plug-in using the following APIs: AVPageViewGetWireframeDrawing AVPageViewSetWireframeDrawing There are no Acrobat JavaScript APIs for wireframe drawings. 58 Acrobat SDK User's Guide 6 Modifying the User Interface This section describes how to change the Acrobat or Adobe Reader user interface using the Acrobat SDK. This chapter consists of the following sections: Adding or Removing Menus and Menu Items Modifying the Toolbar Using the Adobe Dialog Manager (ADM) Customizing Acrobat Help Adding or Removing Menus and Menu Items You can use the Acrobat SDK to manipulate menu items, menus and menu bars. For complete information on what functionality is available with each SDK technology, see the Acrobat and PDF Library API Reference. the Acrobat JavaScript Scripting Reference, or the Acrobat Interapplication Communication Reference. Adding Menu Items You can use a plug-in or Acrobat JavaScript to add or remove menu items or submenus to an existing menu. From JavaScript, use the app object's AddMenuItem, HideMenuItem, and AddSubMenu methods. With IAC OLE automation, you can remove a menu item using the App. MenuItemRemove method. Menu items added by plug-ins can have shortcuts (keyboard accelerators). Acrobat and Adobe Reader do not ensure that plug-ins add unique shortcuts, but it is possible for a plug-in to check which shortcuts are already in use before adding its own. Note that the only way to ensure there are no shortcut conflicts is for all plug-ins to check for conflicts before adding their own shortcuts. You are encouraged to have your plug-in add its menu items to the Tools menu. When it is launched, Acrobat or Adobe Reader automatically adds this menu, as well as the About Plug-ins and Plug-in Help menus (see "Placing Plug-in Help Files in a Standard Location" on page 64). After Acrobat or Adobe Reader loads all plug-ins, it checks these three menus and removes any that are empty. Acrobat SDK User's Guide 59 6 Modifying the User Interface Modifying the Toolbar Adobe keeps a registry of plug-in menu item names to help avoid conflicts between plugins. For more information on registering and using plug-in prefixes, see the Acrobat SDK Plug-in Guide. Adding a New Menu To create a new menu, use the AVMenuNew method from a plug-in. [. . . ] Acrobat issues notifications to accessibility clients about signigicant events occurring in the PDF file window, and responds to requests from such clients. For more information, see Reading PDF Through COM Accessibility Interfaces. 114 Acrobat SDK User's Guide 15 Working With PDF Layers Adobe PDF layers are components of content that may occupy the same physical space as other components. Multiple components may be visible or invisible depending on their settings, and may be used to support the display, navigation, and printing of layered PDF content by various applications. Using the Acrobat SDK, you can display, navigate and print layered PDF documents. [. . . ]