User manual ADOBE ACROBAT SDK 8.1

[. . . ] bc Developing Plug-ins and Applications Adobe® Acrobat® SDK April 2007 Version 8. 1 © 2007 Adobe Systems Incorporated. Adobe® Acrobat® SDK 8. 1 Developing Plug-ins and Applications for Microsoft® Windows®, Mac OS®, Linux® and UNIX® Edition 2. 0, April 2007 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. [. . . ] The AVAlertNote method is invoked and the character pointer is passed as an argument that results in the bookmark's title being displayed within a message box. The PDBookmarkHasChildren method is invoked to determine whether there are any child bookmarks under the current bookmark. If there are child bookmarks, the PDBookmarkGetFirstChild method is invoked to retrieve the first child bookmark. A recursive call is made to VisitAllBookmarks (that is, the user-defined method is invoking itself ) until there are no more children bookmarks. Then the PDBookmarkGetNext method is invoked to get a sibling bookmark and the process continues until there are no more bookmarks within the PDF document. Example 9. 6 Retrieving existing bookmarks //Recursively go through bookmark tree to visit each bookmark void VisitAllBookmarks (PDBookmark aBookmark) { PDBookmark treeBookmark; DURING //Ensure that the bookmark is valid Adobe Acrobat SDK Developing Plug-ins and Applications Working with Bookmarks Deleting bookmarks 120 if (!PDBookmarkIsValid(aBookmark)) E_RTRN_VOID //Get the title of the bookmark char * bmBuf; ASInt32 bufSize = PDBookmarkGetTitle(aBookmark, NULL, 0) +1; //Allocate the size of bufSize to the character pointer bmBuf = (char*)ASmalloc((os_size_t)bufSize); //Populate bmBuf with the bookmark's title PDBookmarkGetTitle(aBookmark, bmBuf, bufSize); //Display the title of the bookmark within a message box AVAlertNote(bmBuf); //Determine if the current bookmark has children bookmark if (PDBookmarkHasChildren (aBookmark)) { //Get the first child of the bookmark treeBookmark = PDBookmarkGetFirstChild(aBookmark); while (PDBookmarkIsValid (treeBookmark)){ VisitAllBookmarks (treeBookmark); treeBookmark = PDBookmarkGetNext(treeBookmark); } } HANDLER END_HANDLER } Deleting bookmarks You can use the Acrobat core API to delete an existing bookmark. Deleting a bookmark deletes child bookmarks; however, PDF document content is not affected. To delete a bookmark, you must invoke the PDBookmarkDestroy method and pass a PDBookmark object that represents the bookmark to delete. For example, consider the bookmark structure shown in the following diagram. Assume, for example, that you want to delete the bookmark titled Copying LiveCycle Print files. Once you delete this bookmark, the API files and XDC files bookmarks are also deleted. To delete the Copying LiveCycle Print files bookmark, you must create a PDBookmark object that represents this bookmark and pass this object to the PDBookmarkDestroy method. The following code example deletes a bookmark. Included in this code example is application logic that retrieves a specific bookmark. For information, see "Retrieving a specific bookmark" on page 118. Adobe Acrobat SDK Developing Plug-ins and Applications Working with Bookmarks Deleting bookmarks 121 Example 9. 7 Deleting a bookmark //Retrieve a bookmark whose title is Samples PDBookmark rootBookmark, myBookmark; char* bookmarkTitle = "Copying LiveCycle Print files"; //Get the root bookmark rootBookmark = PDDocGetBookmarkRoot(myPDDoc); //Retrieve a specific bookmark myBookmark = PDBookmarkGetByTitle(rootBookmark, bookmarkTitle, strlen(bookmarkTitle), -1); if (PDBookmarkIsValid (myBookmark)) AVAlertNote("The bookmark was retrieved"); else AVAlertNote("The bookmark was not retrieved"); //Delete this bookmark PDBookmarkDestroy(myBookmark); Note: In the previous code example, a PDDoc object named myPDDoc is passed to the PDDocGetBookmarkRoot method. For information about creating this object, see "Creating a PDDoc object" on page 83. 10 Working with Page Views and Contents This chapter explains how to display page views and modify page contents. A page view is the area of the Acrobat or Adobe Reader window that displays the visible content of a document page. An example of a page view is a PDF document page displayed within Adobe Reader or Acrobat at a 120% magnification. This chapter contains the following information. Topic About page coordinates About page views Displaying page views Modifying page contents Description Describes the characteristics of page coordinates. Describes the characteristics of page views. See page 122 page 124 page 124 page 125 About page coordinates When working with page views and page contents, most times it is necessary to specify page coordinates. Two coordinate systems are applicable to the Acrobat core API: User space Device space User space is the coordinate system used within PDF documents. It specifies coordinates for most objects in the PD layer. [. . . ] The size of the public/private key pair varies, but should be between 446 to 448 bytes. The size of the returned encrypted key should be 160 bytes. 2. Upload a TAR file containing the public key using the instructions given in step 4 of "Enabling an Adobe Reader plug-in" on page 245. Adobe Acrobat SDK Developing Plug-ins and Applications Creating an Adobe Reader Plug-In Enabling the plug-in for Adobe Reader 249 Enabling the plug-in for Adobe Reader After receiving the digital certificate, enable the plug-in for Adobe Reader, by performing the following tasks: 1. Run the makeppi program. Enter the name of the plug-in that is to be enabled. [. . . ]