Add APIs for getting bookmarks and named destinations.

fpdfsdk/include/fpdfview.h

 // Copyright 2014 PDFium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
  
 // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
 
 
 #ifndef _FPDFVIEW_H_
 #define _FPDFVIEW_H_
 
+#include <string>
 #if defined(_WIN32) && !defined(__WINDOWS__)
 #include <windows.h>
 #endif
 
 // Data types
 typedef void*   FPDF_MODULEMGR;
 
 // PDF types
 typedef void*   FPDF_DOCUMENT;          
 typedef void*   FPDF_PAGE;                      
@@ skipping 95 matching lines @@
 #endif
 
 extern const char g_ExpireDate[];
 extern const char g_ModuleCodes[];
 
 // Exported Functions
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+#ifndef _FPDF_DEF_STR_
+#define _FPDF_DEF_STR_
+        // brief Structure for byte string.
+        // note In SDK, a byte string commonly means a UTF-16LE format string.
+        typedef struct
+        {
+                char*   str;
+                int     len;
+        } FPDF_BSTR;
+#endif
+
 // Function: FPDF_InitLibrary
 //                      Initialize the FPDFSDK library 
 // Parameters:
 //                      None
 // Return value:
 //                      None.
 // Comments:
 //                      You have to call this function before you can call any PDF processing functions.
 
 DLLEXPORT void STDCALL FPDF_InitLibrary();
@@ skipping 459 matching lines @@
 
 // Function: FPDF_VIEWERREF_GetDuplex
 //                      Returns the paper handling option to be used when printing from print dialog.
 // Parameters:
 //                      document        -       Handle to the loaded document.
 // Return value:
 //          The paper handling option to be used when printing.
 //
 DLLEXPORT FPDF_DUPLEXTYPE STDCALL FPDF_VIEWERREF_GetDuplex(FPDF_DOCUMENT document);
 
+// Function: FPDF_CountNamedDests
+//                      Get the count of named destinations in the PDF document.
+// Parameters:
+//                      document        -       Handle to a document
+// Return value:
+//                      The count of named destinations.
+DLLEXPORT FPDF_DWORD STDCALL FPDF_CountNamedDests(FPDF_DOCUMENT document);
+
 // Function: FPDF_GetNamedDestByName
 //                      get a special dest handle by the index.
 // Parameters: 
 //                      document        -       Handle to the loaded document.
 //                      name            -       The name of a special named dest.
 // Return value:
 //                      The handle of the dest.
 //
 DLLEXPORT FPDF_DEST STDCALL FPDF_GetNamedDestByName(FPDF_DOCUMENT document,FPDF_BYTESTRING name);
 
+// Function: FPDF_GetNamedDest
+//                      Get the specified named destinations of the PDF document by index.
+// Parameters:
+//                      document        -       Handle to a document
+//                      index           -       The index of named destination.
+//                      name            -       The name of the named destination.
+// Return value:
+//                      The destination handle of a named destination.
+DLLEXPORT FPDF_DEST STDCALL FPDF_GetNamedDest(FPDF_DOCUMENT document, int index, std::string name);

[Bo Xu, 2015/01/06 18:15:56]

@Tom, @raymes, should we have something like:

FPDF_DEST STDCALL FPDF_GetNamedDest(FPDF_DOCUMENT document, int index,
      char* name, int& len);

and ask the application to manage the string buffer?

[Tom Sepez, 2015/01/06 18:25:44]

Yes.  But the problem is that the application doesn't know how big to make the
buffer.  There are a few ways to deal with this.

1. There's a fixed constant like MAX_NAMELEN somewhere that limits the length of
possible dest names, it must always be enforced upon creation of these dests,
and we require a buffer that big here.

2. We pass a length on input, and return an error if its too small.

3. We have a "query" mode where if |name| is null, we return the required space
for the next call in |len|.

Pick one of these.  Thanks.
 

[Bo Xu, 2015/01/06 23:00:20]

I use the query mode in patch 4. Can you take a look?

+
+
 #ifdef __cplusplus
 };
 #endif
 
 #endif // _FPDFVIEW_H_