#----------------------------------------------------------------------
# Name: wx.lib.pdfwin
-# Purpose: A class that allows the use of the Acrobat PSF reader
+# Purpose: A class that allows the use of the Acrobat PDF reader
# ActiveX control
#
# Author: Robin Dunn
# Copyright: (c) 2004 by Total Control Software
# Licence: wxWindows license
#----------------------------------------------------------------------
-# This module was generated by the wx.activex.GernerateAXModule class
-# (See also the genaxmodule script.)
import wx
-import wx.activex
-clsID = '{CA8A9780-280D-11CF-A24D-444553540000}'
-progID = 'AcroPDF.PDF.1'
+#----------------------------------------------------------------------
+_acroversion = None
+
+def get_acroversion():
+ " Return version of Adobe Acrobat executable or None"
+ global _acroversion
+ if _acroversion == None:
+ import _winreg
+ acrosoft = [r'SOFTWARE\Adobe\Acrobat Reader\%version%\InstallPath',
+ r'SOFTWARE\Adobe\Adobe Acrobat\%version%\InstallPath',]
+
+ for regkey in acrosoft:
+ for version in ('7.0', '6.0', '5.0', '4.0'):
+ try:
+ path = _winreg.QueryValue(_winreg.HKEY_LOCAL_MACHINE,
+ regkey.replace('%version%', version))
+ _acroversion = version
+ break
+ except:
+ continue
+ return _acroversion
+#----------------------------------------------------------------------
-# Create eventTypes and event binders
-wxEVT_Error = wx.activex.RegisterActiveXEvent('OnError')
-wxEVT_Message = wx.activex.RegisterActiveXEvent('OnMessage')
+# The ActiveX module from Acrobat 7.0 has changed and it seems to now
+# require much more from the container than what our wx.activex module
+# provides. If we try to use it via wx.activex then Acrobat crashes.
+# So instead we will use Internet Explorer (via the win32com modules
+# so we can use better dynamic dispatch) and embed the Acrobat control
+# within that. Acrobat provides the IAcroAXDocShim COM class that is
+# accessible via the IE window's Document property after a PDF file
+# has been loaded.
+#
+# Details of the Acrobat reader methods can be found in
+# http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/iac/IACOverview.pdf
+# http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/iac/IACReference.pdf
+#
+# Co-ordinates passed as parameters are in points (1/72 inch).
+
+
+if get_acroversion() >= '7.0':
+
+ from wx.lib.activexwrapper import MakeActiveXClass
+ import win32com.client.gencache
+ _browserModule = win32com.client.gencache.EnsureModule(
+ "{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
+
+ class PDFWindowError(RuntimeError):
+ def __init__(self):
+ RuntimeError.__init__(self, "A PDF must be loaded before calling this method.")
+
+
+ class PDFWindow(wx.Panel):
+ def __init__(self, *args, **kw):
+ wx.Panel.__init__(self, *args, **kw)
+
+ # Make a new class that derives from the WebBrowser class
+ # in the COM module imported above. This class also
+ # derives from wxWindow and implements the machinery
+ # needed to integrate the two worlds.
+ _WebBrowserClass = MakeActiveXClass(_browserModule.WebBrowser)
+ self.ie = _WebBrowserClass(self, -1)
+ sizer = wx.BoxSizer()
+ sizer.Add(self.ie, 1, wx.EXPAND)
+ self.SetSizer(sizer)
+
+
+ def LoadFile(self, fileName):
+ """
+ Opens and displays the specified document within the browser.
+ """
+ if self.ie.Document:
+ return self.ie.Document.LoadFile(fileName)
+ else:
+ self.ie.Navigate2(fileName)
+ return True # can we sense failure at this point?
+
+ def GetVersions(self):
+ """
+ Deprecated: No longer available - do not use.
+ """
+ if self.ie.Document:
+ return self.ie.Document.GetVersions()
+ else:
+ raise PDFWindowError()
+
+ def Print(self):
+ """
+ Prints the document according to the specified options in a user dialog box.
+ """
+ if self.ie.Document:
+ return self.ie.Document.Print()
+ else:
+ raise PDFWindowError()
+
+ def goBackwardStack(self):
+ """
+ Goes to the previous view on the view stack, if it exists.
+ """
+ if self.ie.Document:
+ return self.ie.Document.goBackwardStack()
+ else:
+ raise PDFWindowError()
+
+ def goForwardStack(self):
+ """
+ Goes to the next view on the view stack, if it exists.
+ """
+ if self.ie.Document:
+ return self.ie.Document.goForwardStack()
+ else:
+ raise PDFWindowError()
+
+ def gotoFirstPage(self):
+ """
+ Goes to the first page in the document.
+ """
+ if self.ie.Document:
+ return self.ie.Document.gotoFirstPage()
+ else:
+ raise PDFWindowError()
+
+ def gotoLastPage(self):
+ """
+ Goes to the last page in the document.
+ """
+ if self.ie.Document:
+ return self.ie.Document.gotoLastPage()
+ else:
+ raise PDFWindowError()
+
+ def gotoNextPage(self):
+ """
+ Goes to the next page in the document, if it exists
+ """
+ if self.ie.Document:
+ return self.ie.Document.gotoNextPage()
+ else:
+ raise PDFWindowError()
+
+ def gotoPreviousPage(self):
+ """
+ Goes to the previous page in the document, if it exists.
+ """
+ if self.ie.Document:
+ return self.ie.Document.gotoPreviousPage()
+ else:
+ raise PDFWindowError()
+
+ def printAll(self):
+ """
+ Prints the entire document without displaying a user
+ dialog box. The current printer, page settings, and job
+ settings are used. This method returns immediately, even
+ if the printing has not completed.
+ """
+ if self.ie.Document:
+ return self.ie.Document.printAll()
+ else:
+ raise PDFWindowError()
+
+ def printAllFit(self, shrinkToFit):
+ """
+ Prints the entire document without a user dialog box, and
+ (if shrinkToFit) shrinks pages as needed to fit the
+ imageable area of a page in the printer.
+ """
+ if self.ie.Document:
+ return self.ie.Document.printAllFit(shrinkToFit)
+ else:
+ raise PDFWindowError()
+
+ def printPages(self, from_, to):
+ """
+ Prints the specified pages without displaying a user dialog box.
+ """
+ if self.ie.Document:
+ return self.ie.Document.printPages(from_, to)
+ else:
+ raise PDFWindowError()
+
+ def printPagesFit(self, from_, to, shrinkToFit):
+ """
+ Prints the specified pages without displaying a user
+ dialog box, and (if shrinkToFit) shrinks pages as needed
+ to fit the imageable area of a page in the printer.
+ """
+ if self.ie.Document:
+ return self.ie.Document.printPagesFit( from_, to, shrinkToFit)
+ else:
+ raise PDFWindowError()
+
+ def printWithDialog(self):
+ """
+ Prints the document according to the specified options in
+ a user dialog box. These options may include embedded
+ printing and specifying which printer is to be used.
+
+ NB. The page range in the dialog defaults to
+ 'From Page 1 to 1' - Use Print() above instead. (dfh)
+ """
+ if self.ie.Document:
+ return self.ie.Document.printWithDialog()
+ else:
+ raise PDFWindowError()
+
+ def setCurrentHighlight(self, a, b, c, d):
+ if self.ie.Document:
+ return self.ie.Document.setCurrentHighlight(a, b, c, d)
+ else:
+ raise PDFWindowError()
+
+ def setCurrentPage(self, npage):
+ """
+ Goes to the specified page in the document. Maintains the
+ current location within the page and zoom level. npage is
+ the page number of the destination page. The first page
+ in a document is page 0.
+
+ ## Oh no it isn't! The first page is 1 (dfh)
+ """
+ if self.ie.Document:
+ return self.ie.Document.setCurrentPage(npage)
+ else:
+ raise PDFWindowError()
+
+ def setLayoutMode(self, layoutMode):
+ """
+ LayoutMode possible values:
+
+ ================= ====================================
+ 'DontCare' use the current user preference
+ 'SinglePage' use single page mode (as in pre-Acrobat
+ 3.0 viewers)
+ 'OneColumn' use one-column continuous mode
+ 'TwoColumnLeft' use two-column continuous mode, first
+ page on the left
+ 'TwoColumnRight' use two-column continuous mode, first
+ page on the right
+ ================= ====================================
+ """
+ if self.ie.Document:
+ return self.ie.Document.setLayoutMode(layoutMode)
+ else:
+ raise PDFWindowError()
+
+ def setNamedDest(self, namedDest):
+ """
+ Changes the page view to the named destination in the specified string.
+ """
+ if self.ie.Document:
+ return self.ie.Document.setNamedDest(namedDest)
+ else:
+ raise PDFWindowError()
+
+ def setPageMode(self, pageMode):
+ """
+ Sets the page mode to display the document only, or to
+ additionally display bookmarks or thumbnails. pageMode =
+ 'none' or 'bookmarks' or 'thumbs'.
+
+ ## NB.'thumbs' is case-sensitive, the other are not (dfh)
+ """
+ if self.ie.Document:
+ return self.ie.Document.setPageMode(pageMode)
+ else:
+ raise PDFWindowError()
+
+ def setShowScrollbars(self, On):
+ """
+ Determines whether scrollbars will appear in the document
+ view.
+
+ ## NB. If scrollbars are off, the navigation tools disappear as well (dfh)
+ """
+ if self.ie.Document:
+ return self.ie.Document.setShowScrollbars(On)
+ else:
+ raise PDFWindowError()
+
+ def setShowToolbar(self, On):
+ """
+ Determines whether a toolbar will appear in the application.
+ """
+ if self.ie.Document:
+ return self.ie.Document.setShowToolbar(On)
+ else:
+ raise PDFWindowError()
+
+ def setView(self, viewMode):
+ """
+ Determines how the page will fit in the current view.
+ viewMode possible values:
+
+ ======== ==============================================
+ 'Fit' fits whole page within the window both vertically
+ and horizontally.
+ 'FitH' fits the width of the page within the window.
+ 'FitV' fits the height of the page within the window.
+ 'FitB' fits bounding box within the window both vertically
+ and horizontally.
+ 'FitBH' fits the width of the bounding box within the window.
+ 'FitBV' fits the height of the bounding box within the window.
+ ======== ==============================================
+ """
+ if self.ie.Document:
+ return self.ie.Document.setView(viewMode)
+ else:
+ raise PDFWindowError()
+
+ def setViewRect(self, left, top, width, height):
+ """
+ Sets the view rectangle according to the specified coordinates.
+
+ :param left: The upper left horizontal coordinate.
+ :param top: The vertical coordinate in the upper left corner.
+ :param width: The horizontal width of the rectangle.
+ :param height: The vertical height of the rectangle.
+ """
+ if self.ie.Document:
+ return self.ie.Document.setViewRect(left, top, width, height)
+ else:
+ raise PDFWindowError()
+
+ def setViewScroll(self, viewMode, offset):
+ """
+ Sets the view of a page according to the specified string.
+ Depending on the view mode, the page is either scrolled to
+ the right or scrolled down by the amount specified in
+ offset. Possible values of viewMode are as in setView
+ above. offset is the horizontal or vertical coordinate
+ positioned either at the left or top edge.
+ """
+ if self.ie.Document:
+ return self.ie.Document.setViewScroll(viewMode, offset)
+ else:
+ raise PDFWindowError()
+
+ def setZoom(self, percent):
+ """
+ Sets the magnification according to the specified value
+ expressed as a percentage (float)
+ """
+ if self.ie.Document:
+ return self.ie.Document.setZoom(percent)
+ else:
+ raise PDFWindowError()
+
+ def setZoomScroll(self, percent, left, top):
+ """
+ Sets the magnification according to the specified value,
+ and scrolls the page view both horizontally and vertically
+ according to the specified amounts.
+
+ :param left: the horizontal coordinate positioned at the left edge.
+ :param top: the vertical coordinate positioned at the top edge.
+ """
+ if self.ie.Document:
+ return self.ie.Document.setZoomScroll(percent, left, top)
+ else:
+ raise PDFWindowError()
-EVT_Error = wx.PyEventBinder(wxEVT_Error, 1)
-EVT_Message = wx.PyEventBinder(wxEVT_Message, 1)
+
+else:
+ import wx.activex
-# Derive a new class from ActiveXWindow
-class PDFWindow(wx.activex.ActiveXWindow):
- def __init__(self, parent, ID=-1, pos=wx.DefaultPosition,
- size=wx.DefaultSize, style=0, name='PDFWindow'):
- wx.activex.ActiveXWindow.__init__(self, parent,
- wx.activex.CLSID('{CA8A9780-280D-11CF-A24D-444553540000}'),
- ID, pos, size, style, name)
-
- # Methods exported by the ActiveX object
- def QueryInterface(self, riid):
- return self.CallAXMethod('QueryInterface', riid)
+ clsID = '{CA8A9780-280D-11CF-A24D-444553540000}'
+ progID = 'AcroPDF.PDF.1'
+
+
+ # Create eventTypes and event binders
+ wxEVT_Error = wx.activex.RegisterActiveXEvent('OnError')
+ wxEVT_Message = wx.activex.RegisterActiveXEvent('OnMessage')
+
+ EVT_Error = wx.PyEventBinder(wxEVT_Error, 1)
+ EVT_Message = wx.PyEventBinder(wxEVT_Message, 1)
+
+
+ # Derive a new class from ActiveXWindow
+ class PDFWindow(wx.activex.ActiveXWindow):
+ def __init__(self, parent, ID=-1, pos=wx.DefaultPosition,
+ size=wx.DefaultSize, style=0, name='PDFWindow'):
+ wx.activex.ActiveXWindow.__init__(self, parent,
+ wx.activex.CLSID('{CA8A9780-280D-11CF-A24D-444553540000}'),
+ ID, pos, size, style, name)
- def AddRef(self):
- return self.CallAXMethod('AddRef')
+ # Methods exported by the ActiveX object
+ def QueryInterface(self, riid):
+ return self.CallAXMethod('QueryInterface', riid)
- def Release(self):
- return self.CallAXMethod('Release')
+ def AddRef(self):
+ return self.CallAXMethod('AddRef')
- def GetTypeInfoCount(self):
- return self.CallAXMethod('GetTypeInfoCount')
+ def Release(self):
+ return self.CallAXMethod('Release')
- def GetTypeInfo(self, itinfo, lcid):
- return self.CallAXMethod('GetTypeInfo', itinfo, lcid)
+ def GetTypeInfoCount(self):
+ return self.CallAXMethod('GetTypeInfoCount')
- def GetIDsOfNames(self, riid, rgszNames, cNames, lcid):
- return self.CallAXMethod('GetIDsOfNames', riid, rgszNames, cNames, lcid)
+ def GetTypeInfo(self, itinfo, lcid):
+ return self.CallAXMethod('GetTypeInfo', itinfo, lcid)
- def Invoke(self, dispidMember, riid, lcid, wFlags, pdispparams):
- return self.CallAXMethod('Invoke', dispidMember, riid, lcid, wFlags, pdispparams)
+ def GetIDsOfNames(self, riid, rgszNames, cNames, lcid):
+ return self.CallAXMethod('GetIDsOfNames', riid, rgszNames, cNames, lcid)
- def LoadFile(self, fileName):
- return self.CallAXMethod('LoadFile', fileName)
+ def Invoke(self, dispidMember, riid, lcid, wFlags, pdispparams):
+ return self.CallAXMethod('Invoke', dispidMember, riid, lcid, wFlags, pdispparams)
- def setShowToolbar(self, On):
- return self.CallAXMethod('setShowToolbar', On)
+ def LoadFile(self, fileName):
+ return self.CallAXMethod('LoadFile', fileName)
- def gotoFirstPage(self):
- return self.CallAXMethod('gotoFirstPage')
+ def setShowToolbar(self, On):
+ return self.CallAXMethod('setShowToolbar', On)
- def gotoLastPage(self):
- return self.CallAXMethod('gotoLastPage')
+ def gotoFirstPage(self):
+ return self.CallAXMethod('gotoFirstPage')
- def gotoNextPage(self):
- return self.CallAXMethod('gotoNextPage')
+ def gotoLastPage(self):
+ return self.CallAXMethod('gotoLastPage')
- def gotoPreviousPage(self):
- return self.CallAXMethod('gotoPreviousPage')
+ def gotoNextPage(self):
+ return self.CallAXMethod('gotoNextPage')
- def setCurrentPage(self, n):
- return self.CallAXMethod('setCurrentPage', n)
+ def gotoPreviousPage(self):
+ return self.CallAXMethod('gotoPreviousPage')
- def goForwardStack(self):
- return self.CallAXMethod('goForwardStack')
+ def setCurrentPage(self, n):
+ return self.CallAXMethod('setCurrentPage', n)
- def goBackwardStack(self):
- return self.CallAXMethod('goBackwardStack')
+ def goForwardStack(self):
+ return self.CallAXMethod('goForwardStack')
- def setPageMode(self, pageMode):
- return self.CallAXMethod('setPageMode', pageMode)
+ def goBackwardStack(self):
+ return self.CallAXMethod('goBackwardStack')
- def setLayoutMode(self, layoutMode):
- return self.CallAXMethod('setLayoutMode', layoutMode)
+ def setPageMode(self, pageMode):
+ return self.CallAXMethod('setPageMode', pageMode)
- def setNamedDest(self, namedDest):
- return self.CallAXMethod('setNamedDest', namedDest)
+ def setLayoutMode(self, layoutMode):
+ return self.CallAXMethod('setLayoutMode', layoutMode)
- def Print(self):
- return self.CallAXMethod('Print')
+ def setNamedDest(self, namedDest):
+ return self.CallAXMethod('setNamedDest', namedDest)
- def printWithDialog(self):
- return self.CallAXMethod('printWithDialog')
+ def Print(self):
+ return self.CallAXMethod('Print')
- def setZoom(self, percent):
- return self.CallAXMethod('setZoom', percent)
+ def printWithDialog(self):
+ return self.CallAXMethod('printWithDialog')
- def setZoomScroll(self, percent, left, top):
- return self.CallAXMethod('setZoomScroll', percent, left, top)
+ def setZoom(self, percent):
+ return self.CallAXMethod('setZoom', percent)
- def setView(self, viewMode):
- return self.CallAXMethod('setView', viewMode)
+ def setZoomScroll(self, percent, left, top):
+ return self.CallAXMethod('setZoomScroll', percent, left, top)
- def setViewScroll(self, viewMode, offset):
- return self.CallAXMethod('setViewScroll', viewMode, offset)
+ def setView(self, viewMode):
+ return self.CallAXMethod('setView', viewMode)
- def setViewRect(self, left, top, width, height):
- return self.CallAXMethod('setViewRect', left, top, width, height)
+ def setViewScroll(self, viewMode, offset):
+ return self.CallAXMethod('setViewScroll', viewMode, offset)
- def printPages(self, from_, to):
- return self.CallAXMethod('printPages', from_, to)
+ def setViewRect(self, left, top, width, height):
+ return self.CallAXMethod('setViewRect', left, top, width, height)
- def printPagesFit(self, from_, to, shrinkToFit):
- return self.CallAXMethod('printPagesFit', from_, to, shrinkToFit)
+ def printPages(self, from_, to):
+ return self.CallAXMethod('printPages', from_, to)
- def printAll(self):
- return self.CallAXMethod('printAll')
+ def printPagesFit(self, from_, to, shrinkToFit):
+ return self.CallAXMethod('printPagesFit', from_, to, shrinkToFit)
- def printAllFit(self, shrinkToFit):
- return self.CallAXMethod('printAllFit', shrinkToFit)
+ def printAll(self):
+ return self.CallAXMethod('printAll')
- def setShowScrollbars(self, On):
- return self.CallAXMethod('setShowScrollbars', On)
+ def printAllFit(self, shrinkToFit):
+ return self.CallAXMethod('printAllFit', shrinkToFit)
- def GetVersions(self):
- return self.CallAXMethod('GetVersions')
+ def setShowScrollbars(self, On):
+ return self.CallAXMethod('setShowScrollbars', On)
- def setCurrentHightlight(self, a, b, c, d):
- return self.CallAXMethod('setCurrentHightlight', a, b, c, d)
+ def GetVersions(self):
+ return self.CallAXMethod('GetVersions')
- def setCurrentHighlight(self, a, b, c, d):
- return self.CallAXMethod('setCurrentHighlight', a, b, c, d)
+ def setCurrentHighlight(self, a, b, c, d):
+ return self.CallAXMethod('setCurrentHighlight', a, b, c, d)
- def postMessage(self, strArray):
- return self.CallAXMethod('postMessage', strArray)
+ def postMessage(self, strArray):
+ return self.CallAXMethod('postMessage', strArray)
- # Getters, Setters and properties
- def _get_src(self):
- return self.GetAXProp('src')
- def _set_src(self, src):
- self.SetAXProp('src', src)
- src = property(_get_src, _set_src)
+ # Getters, Setters and properties
+ def _get_src(self):
+ return self.GetAXProp('src')
+ def _set_src(self, src):
+ self.SetAXProp('src', src)
+ src = property(_get_src, _set_src)
- def _get_messageHandler(self):
- return self.GetAXProp('messageHandler')
- def _set_messageHandler(self, messageHandler):
- self.SetAXProp('messageHandler', messageHandler)
- messagehandler = property(_get_messageHandler, _set_messageHandler)
+ def _get_messageHandler(self):
+ return self.GetAXProp('messageHandler')
+ def _set_messageHandler(self, messageHandler):
+ self.SetAXProp('messageHandler', messageHandler)
+ messagehandler = property(_get_messageHandler, _set_messageHandler)
# PROPERTIES
projects / wxWidgets.git / blobdiff