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 574 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);

[Tom Sepez, 2015/01/01 01:10:07]

This is inside an extern C block, so we don't get to use std::string here :(.

[raymes, 2015/01/05 22:38:09]

This seems like it is just an in-parameter, is that correct? If so, can we just
use a char*?

As an aside I'm a bit confused about this API since it has both an index and a
name. What happens if I specify both? How would I go about iterating through all
of the named destinations in the document?

Thanks!!

[Bo Xu, 2015/01/05 22:46:52]

Ohh, my mistake, this should be passed by reference. Originally it passes
FPDF_BSTR*. It intends to get the name of a particular index.

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