include/wx/msw/webview_ie.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        include/wx/msw/webview_ie.h
   3 // Purpose:     wxMSW IE wxWebView backend
   4 // Author:      Marianne Gagnon
   5 // Id:          $Id$
   6 // Copyright:   (c) 2010 Marianne Gagnon, 2011 Steven Lamerton
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifndef wxWebViewIE_H
  11 #define wxWebViewIE_H
  12
  13 #include "wx/setup.h"
  14
  15 #if wxUSE_WEBVIEW && wxUSE_WEBVIEW_IE && defined(__WXMSW__)
  16
  17 #include "wx/control.h"
  18 #include "wx/webview.h"
  19 #include "wx/msw/ole/automtn.h"
  20 #include "wx/msw/ole/activex.h"
  21 #include "wx/msw/ole/oleutils.h"
  22 #include "wx/msw/private/comptr.h"
  23 #include "wx/msw/wrapwin.h"
  24 #include "wx/msw/missing.h"
  25 #include "wx/msw/webview_missing.h"
  26 #include "wx/sharedptr.h"
  27 #include "wx/vector.h"
  28
  29 struct IHTMLDocument2;
  30 struct IHTMLElement;
  31 struct IMarkupPointer;
  32 class wxFSFile;
  33 class ClassFactory;
  34 class wxIEContainer;
  35 class DocHostUIHandler;
  36 class wxFindPointers;
  37 class wxIInternetProtocol;
  38
  39 class WXDLLIMPEXP_WEBVIEW wxWebViewIE : public wxWebView
  40 {
  41 public:
  42
  43     wxWebViewIE() {}
  44
  45     wxWebViewIE(wxWindow* parent,
  46            wxWindowID id,
  47            const wxString& url = wxWebViewDefaultURLStr,
  48            const wxPoint& pos = wxDefaultPosition,
  49            const wxSize& size = wxDefaultSize,
  50            long style = 0,
  51            const wxString& name = wxWebViewNameStr)
  52    {
  53        Create(parent, id, url, pos, size, style, name);
  54    }
  55
  56     ~wxWebViewIE();
  57
  58     bool Create(wxWindow* parent,
  59            wxWindowID id,
  60            const wxString& url = wxWebViewDefaultURLStr,
  61            const wxPoint& pos = wxDefaultPosition,
  62            const wxSize& size = wxDefaultSize,
  63            long style = 0,
  64            const wxString& name = wxWebViewNameStr);
  65
  66     virtual void LoadURL(const wxString& url);
  67     virtual void LoadHistoryItem(wxSharedPtr<wxWebViewHistoryItem> item);
  68     virtual wxVector<wxSharedPtr<wxWebViewHistoryItem> > GetBackwardHistory();
  69     virtual wxVector<wxSharedPtr<wxWebViewHistoryItem> > GetForwardHistory();
  70
  71     virtual bool CanGoForward() const;
  72     virtual bool CanGoBack() const;
  73     virtual void GoBack();
  74     virtual void GoForward();
  75     virtual void ClearHistory();
  76     virtual void EnableHistory(bool enable = true);
  77     virtual void Stop();
  78     virtual void Reload(wxWebViewReloadFlags flags = wxWEB_VIEW_RELOAD_DEFAULT);
  79
  80     virtual wxString GetPageSource() const;
  81     virtual wxString GetPageText() const;
  82
  83     virtual bool IsBusy() const;
  84     virtual wxString GetCurrentURL() const;
  85     virtual wxString GetCurrentTitle() const;
  86
  87     virtual void SetZoomType(wxWebViewZoomType);
  88     virtual wxWebViewZoomType GetZoomType() const;
  89     virtual bool CanSetZoomType(wxWebViewZoomType) const;
  90
  91     virtual void Print();
  92
  93     virtual wxWebViewZoom GetZoom() const;
  94     virtual void SetZoom(wxWebViewZoom zoom);
  95
  96     //Clipboard functions
  97     virtual bool CanCut() const;
  98     virtual bool CanCopy() const;
  99     virtual bool CanPaste() const;
 100     virtual void Cut();
 101     virtual void Copy();
 102     virtual void Paste();
 103
 104     //Undo / redo functionality
 105     virtual bool CanUndo() const;
 106     virtual bool CanRedo() const;
 107     virtual void Undo();
 108     virtual void Redo();
 109
 110     //Find function
 111     virtual long Find(const wxString& text, int flags = wxWEB_VIEW_FIND_DEFAULT);
 112
 113     //Editing functions
 114     virtual void SetEditable(bool enable = true);
 115     virtual bool IsEditable() const;
 116
 117     //Selection
 118     virtual void SelectAll();
 119     virtual bool HasSelection() const;
 120     virtual void DeleteSelection();
 121     virtual wxString GetSelectedText() const;
 122     virtual wxString GetSelectedSource() const;
 123     virtual void ClearSelection();
 124
 125     virtual void RunScript(const wxString& javascript);
 126
 127     //Virtual Filesystem Support
 128     virtual void RegisterHandler(wxSharedPtr<wxWebViewHandler> handler);
 129
 130     virtual void* GetNativeBackend() const { return m_webBrowser; }
 131
 132     // ---- IE-specific methods
 133
 134     // FIXME: I seem to be able to access remote webpages even in offline mode...
 135     bool IsOfflineMode();
 136     void SetOfflineMode(bool offline);
 137
 138     wxWebViewZoom GetIETextZoom() const;
 139     void SetIETextZoom(wxWebViewZoom level);
 140
 141     wxWebViewZoom GetIEOpticalZoom() const;
 142     void SetIEOpticalZoom(wxWebViewZoom level);
 143
 144     void onActiveXEvent(wxActiveXEvent& evt);
 145     void onEraseBg(wxEraseEvent&) {}
 146
 147     DECLARE_EVENT_TABLE();
 148
 149 protected:
 150     virtual void DoSetPage(const wxString& html, const wxString& baseUrl);
 151
 152 private:
 153     wxIEContainer* m_container;
 154     wxAutomationObject m_ie;
 155     IWebBrowser2* m_webBrowser;
 156     DWORD m_dwCookie;
 157     wxCOMPtr<DocHostUIHandler> m_uiHandler;
 158
 159     //We store the current zoom type;
 160     wxWebViewZoomType m_zoomType;
 161
 162     /** The "Busy" property of IWebBrowser2 does not always return busy when
 163      *  we'd want it to; this variable may be set to true in cases where the
 164      *  Busy property is false but should be true.
 165      */
 166     bool m_isBusy;
 167     //We manage our own history, the history list contains the history items
 168     //which are added as documentcomplete events arrive, unless we are loading
 169     //an item from the history. The position is stored as an int, and reflects
 170     //where we are in the history list.
 171     wxVector<wxSharedPtr<wxWebViewHistoryItem> > m_historyList;
 172     wxVector<ClassFactory*> m_factories;
 173     int m_historyPosition;
 174     bool m_historyLoadingFromList;
 175     bool m_historyEnabled;
 176
 177     //We store find flag, results and position.
 178     wxVector<wxFindPointers> m_findPointers;
 179     int m_findFlags;
 180     wxString m_findText;
 181     int m_findPosition;
 182
 183     //Generic helper functions
 184     bool CanExecCommand(wxString command) const;
 185     void ExecCommand(wxString command);
 186     wxCOMPtr<IHTMLDocument2> GetDocument() const;
 187     bool IsElementVisible(IHTMLElement* elm);
 188     //Find helper functions.
 189     void FindInternal(const wxString& text, int flags, int internal_flag);
 190     long FindNext(int direction = 1);
 191     void FindClear();
 192     //Toggles control features see INTERNETFEATURELIST for values.
 193     bool EnableControlFeature(long flag, bool enable = true);
 194
 195     wxDECLARE_DYNAMIC_CLASS(wxWebViewIE);
 196 };
 197
 198 class VirtualProtocol : public wxIInternetProtocol
 199 {
 200 protected:
 201     wxIInternetProtocolSink* m_protocolSink;
 202     wxString m_html;
 203     VOID * fileP;
 204
 205     wxFSFile* m_file;
 206     wxSharedPtr<wxWebViewHandler> m_handler;
 207
 208 public:
 209     VirtualProtocol(wxSharedPtr<wxWebViewHandler> handler);
 210     ~VirtualProtocol() {}
 211
 212     //IUnknown
 213     DECLARE_IUNKNOWN_METHODS;
 214
 215     //IInternetProtocolRoot
 216     HRESULT STDMETHODCALLTYPE Abort(HRESULT WXUNUSED(hrReason),
 217                                     DWORD WXUNUSED(dwOptions))
 218                                    { return E_NOTIMPL; }
 219     HRESULT STDMETHODCALLTYPE Continue(wxPROTOCOLDATA *WXUNUSED(pProtocolData))
 220                                        { return S_OK; }
 221     HRESULT STDMETHODCALLTYPE Resume() { return S_OK; }
 222     HRESULT STDMETHODCALLTYPE Start(LPCWSTR szUrl,
 223                                     wxIInternetProtocolSink *pOIProtSink,
 224                                     wxIInternetBindInfo *pOIBindInfo,
 225                                     DWORD grfPI,
 226                                     HANDLE_PTR dwReserved);
 227     HRESULT STDMETHODCALLTYPE Suspend() { return S_OK; }
 228     HRESULT STDMETHODCALLTYPE Terminate(DWORD WXUNUSED(dwOptions)) { return S_OK; }
 229
 230     //IInternetProtocol
 231     HRESULT STDMETHODCALLTYPE LockRequest(DWORD WXUNUSED(dwOptions))
 232                                           { return S_OK; }
 233     HRESULT STDMETHODCALLTYPE Read(void *pv, ULONG cb, ULONG *pcbRead);
 234     HRESULT STDMETHODCALLTYPE Seek(LARGE_INTEGER WXUNUSED(dlibMove),
 235                                    DWORD WXUNUSED(dwOrigin),
 236                                    ULARGE_INTEGER* WXUNUSED(plibNewPosition))
 237                                    { return E_FAIL; }
 238     HRESULT STDMETHODCALLTYPE UnlockRequest() { return S_OK; }
 239 };
 240
 241 class ClassFactory : public IClassFactory
 242 {
 243 public:
 244     ClassFactory(wxSharedPtr<wxWebViewHandler> handler) : m_handler(handler) {}
 245
 246     //IClassFactory
 247     HRESULT STDMETHODCALLTYPE CreateInstance(IUnknown* pUnkOuter,
 248                                              REFIID riid, void** ppvObject);
 249     HRESULT STDMETHODCALLTYPE LockServer(BOOL fLock);
 250
 251     //IUnknown
 252     DECLARE_IUNKNOWN_METHODS;
 253
 254 private:
 255     wxSharedPtr<wxWebViewHandler> m_handler;
 256 };
 257
 258 class wxIEContainer : public wxActiveXContainer
 259 {
 260 public:
 261     wxIEContainer(wxWindow *parent, REFIID iid, IUnknown *pUnk, DocHostUIHandler* uiHandler = NULL);
 262     virtual ~wxIEContainer();
 263     virtual bool QueryClientSiteInterface(REFIID iid, void **_interface, const char *&desc);
 264 private:
 265     DocHostUIHandler* m_uiHandler;
 266 };
 267
 268 class DocHostUIHandler : public wxIDocHostUIHandler
 269 {
 270 public:
 271     DocHostUIHandler() {};
 272     ~DocHostUIHandler() {};
 273     virtual HRESULT wxSTDCALL ShowContextMenu(DWORD dwID, POINT *ppt,
 274                                               IUnknown *pcmdtReserved,
 275                                               IDispatch *pdispReserved);
 276
 277     virtual HRESULT wxSTDCALL GetHostInfo(DOCHOSTUIINFO *pInfo);
 278
 279     virtual HRESULT wxSTDCALL ShowUI(DWORD dwID,
 280                                      IOleInPlaceActiveObject *pActiveObject,
 281                                      IOleCommandTarget *pCommandTarget,
 282                                      IOleInPlaceFrame *pFrame,
 283                                      IOleInPlaceUIWindow *pDoc);
 284
 285     virtual HRESULT wxSTDCALL HideUI(void);
 286
 287     virtual HRESULT wxSTDCALL UpdateUI(void);
 288
 289     virtual HRESULT wxSTDCALL EnableModeless(BOOL fEnable);
 290
 291     virtual HRESULT wxSTDCALL OnDocWindowActivate(BOOL fActivate);
 292
 293     virtual HRESULT wxSTDCALL OnFrameWindowActivate(BOOL fActivate);
 294
 295     virtual HRESULT wxSTDCALL ResizeBorder(LPCRECT prcBorder,
 296                                            IOleInPlaceUIWindow *pUIWindow,
 297                                            BOOL fRameWindow);
 298
 299     virtual HRESULT wxSTDCALL TranslateAccelerator(LPMSG lpMsg,
 300                                                    const GUID *pguidCmdGroup,
 301                                                    DWORD nCmdID);
 302
 303     virtual HRESULT wxSTDCALL GetOptionKeyPath(LPOLESTR *pchKey,
 304                                                DWORD dw);
 305
 306     virtual HRESULT wxSTDCALL GetDropTarget(IDropTarget *pDropTarget,
 307                                             IDropTarget **ppDropTarget);
 308
 309     virtual HRESULT wxSTDCALL GetExternal(IDispatch **ppDispatch);
 310
 311     virtual HRESULT wxSTDCALL TranslateUrl(DWORD dwTranslate,
 312                                            OLECHAR *pchURLIn,
 313                                            OLECHAR **ppchURLOut);
 314
 315     virtual HRESULT wxSTDCALL FilterDataObject(IDataObject *pDO,
 316                                                IDataObject **ppDORet);
 317     //IUnknown
 318     DECLARE_IUNKNOWN_METHODS;
 319 };
 320
 321 class wxFindPointers
 322 {
 323 public:
 324     wxFindPointers(wxIMarkupPointer *ptrBegin, wxIMarkupPointer *ptrEnd)
 325     {
 326         begin = ptrBegin;
 327         end = ptrEnd;
 328     }
 329     //The two markup pointers.
 330     wxIMarkupPointer *begin, *end;
 331 };
 332
 333 #endif // wxUSE_WEBVIEW && wxUSE_WEBVIEW_IE && defined(__WXMSW__)
 334
 335 #endif // wxWebViewIE_H