1 /////////////////////////////////////////////////////////////////////////////
2 // Name: include/wx/msw/webviewie.h
3 // Purpose: wxMSW IE wxWebView backend
4 // Author: Marianne Gagnon
6 // Copyright: (c) 2010 Marianne Gagnon, 2011 Steven Lamerton
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
15 #if wxUSE_WEBVIEW && wxUSE_WEBVIEW_IE && defined(__WXMSW__)
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/sharedptr.h"
26 #include "wx/vector.h"
28 /* Classes and definitions from urlmon.h vary in their
29 * completeness between compilers and versions of compilers.
30 * We implement our own versions here which should work
31 * for all compilers. The definitions are taken from the
32 * mingw-w64 headers which are public domain.
35 #ifndef REFRESH_NORMAL
36 #define REFRESH_NORMAL 0
39 #ifndef REFRESH_COMPLETELY
40 #define REFRESH_COMPLETELY 3
43 typedef enum __wxMIDL_IBindStatusCallback_0006
45 wxBSCF_FIRSTDATANOTIFICATION
= 0x1,
46 wxBSCF_INTERMEDIATEDATANOTIFICATION
= 0x2,
47 wxBSCF_LASTDATANOTIFICATION
= 0x4,
48 wxBSCF_DATAFULLYAVAILABLE
= 0x8,
49 wxBSCF_AVAILABLEDATASIZEUNKNOWN
= 0x10
52 EXTERN_C
const IID CLSID_FileProtocol
;
54 typedef struct _tagwxBINDINFO
66 SECURITY_ATTRIBUTES securityAttributes
;
72 typedef struct _tagwxPROTOCOLDATA
80 class wxIInternetBindInfo
: public IUnknown
83 virtual HRESULT wxSTDCALL
GetBindInfo(DWORD
*grfBINDF
,wxBINDINFO
*pbindinfo
) = 0;
84 virtual HRESULT wxSTDCALL
GetBindString(ULONG ulStringType
,LPOLESTR
*ppwzStr
,
85 ULONG cEl
,ULONG
*pcElFetched
) = 0;
88 class wxIInternetProtocolSink
: public IUnknown
91 virtual HRESULT wxSTDCALL
Switch(wxPROTOCOLDATA
*pProtocolData
) = 0;
92 virtual HRESULT wxSTDCALL
ReportProgress(ULONG ulStatusCode
,
93 LPCWSTR szStatusText
) = 0;
94 virtual HRESULT wxSTDCALL
ReportData(DWORD grfBSCF
,ULONG ulProgress
,
95 ULONG ulProgressMax
) = 0;
96 virtual HRESULT wxSTDCALL
ReportResult(HRESULT hrResult
,DWORD dwError
,
97 LPCWSTR szResult
) = 0;
100 class wxIInternetProtocolRoot
: public IUnknown
103 virtual HRESULT wxSTDCALL
Start(LPCWSTR szUrl
,wxIInternetProtocolSink
*pOIProtSink
,
104 wxIInternetBindInfo
*pOIBindInfo
,DWORD grfPI
,
105 HANDLE_PTR dwReserved
) = 0;
106 virtual HRESULT wxSTDCALL
Continue(wxPROTOCOLDATA
*pProtocolData
) = 0;
107 virtual HRESULT wxSTDCALL
Abort(HRESULT hrReason
,DWORD dwOptions
) = 0;
108 virtual HRESULT wxSTDCALL
Terminate(DWORD dwOptions
) = 0;
109 virtual HRESULT wxSTDCALL
Suspend(void) = 0;
110 virtual HRESULT wxSTDCALL
Resume(void) = 0;
114 class wxIInternetProtocol
: public wxIInternetProtocolRoot
117 virtual HRESULT wxSTDCALL
Read(void *pv
,ULONG cb
,ULONG
*pcbRead
) = 0;
118 virtual HRESULT wxSTDCALL
Seek(LARGE_INTEGER dlibMove
,DWORD dwOrigin
,
119 ULARGE_INTEGER
*plibNewPosition
) = 0;
120 virtual HRESULT wxSTDCALL
LockRequest(DWORD dwOptions
) = 0;
121 virtual HRESULT wxSTDCALL
UnlockRequest(void) = 0;
125 class wxIInternetSession
: public IUnknown
128 virtual HRESULT wxSTDCALL
RegisterNameSpace(IClassFactory
*pCF
,REFCLSID rclsid
,
131 const LPCWSTR
*ppwzPatterns
,
132 DWORD dwReserved
) = 0;
133 virtual HRESULT wxSTDCALL
UnregisterNameSpace(IClassFactory
*pCF
,
134 LPCWSTR pszProtocol
) = 0;
135 virtual HRESULT wxSTDCALL
RegisterMimeFilter(IClassFactory
*pCF
,
137 LPCWSTR pwzType
) = 0;
138 virtual HRESULT wxSTDCALL
UnregisterMimeFilter(IClassFactory
*pCF
,
139 LPCWSTR pwzType
) = 0;
140 virtual HRESULT wxSTDCALL
CreateBinding(LPBC pBC
,LPCWSTR szUrl
,
141 IUnknown
*pUnkOuter
,IUnknown
**ppUnk
,
142 wxIInternetProtocol
**ppOInetProt
,
144 virtual HRESULT wxSTDCALL
SetSessionOption(DWORD dwOption
,LPVOID pBuffer
,
145 DWORD dwBufferLength
,
146 DWORD dwReserved
) = 0;
147 virtual HRESULT wxSTDCALL
GetSessionOption(DWORD dwOption
,LPVOID pBuffer
,
148 DWORD
*pdwBufferLength
,
149 DWORD dwReserved
) = 0;
152 /* END OF URLMON.H implementation */
154 /* Same goes for the mshtmhst.h, these are also taken
155 * from mingw-w64 headers.
158 typedef enum _tagwxDOCHOSTUIFLAG
160 DOCHOSTUIFLAG_DIALOG
= 0x1,
161 DOCHOSTUIFLAG_DISABLE_HELP_MENU
= 0x2,
162 DOCHOSTUIFLAG_NO3DBORDER
= 0x4,
163 DOCHOSTUIFLAG_SCROLL_NO
= 0x8,
164 DOCHOSTUIFLAG_DISABLE_SCRIPT_INACTIVE
= 0x10,
165 DOCHOSTUIFLAG_OPENNEWWIN
= 0x20,
166 DOCHOSTUIFLAG_DISABLE_OFFSCREEN
= 0x40,
167 DOCHOSTUIFLAG_FLAT_SCROLLBAR
= 0x80,
168 DOCHOSTUIFLAG_DIV_BLOCKDEFAULT
= 0x100,
169 DOCHOSTUIFLAG_ACTIVATE_CLIENTHIT_ONLY
= 0x200,
170 DOCHOSTUIFLAG_OVERRIDEBEHAVIORFACTORY
= 0x400,
171 DOCHOSTUIFLAG_CODEPAGELINKEDFONTS
= 0x800,
172 DOCHOSTUIFLAG_URL_ENCODING_DISABLE_UTF8
= 0x1000,
173 DOCHOSTUIFLAG_URL_ENCODING_ENABLE_UTF8
= 0x2000,
174 DOCHOSTUIFLAG_ENABLE_FORMS_AUTOCOMPLETE
= 0x4000,
175 DOCHOSTUIFLAG_ENABLE_INPLACE_NAVIGATION
= 0x10000,
176 DOCHOSTUIFLAG_IME_ENABLE_RECONVERSION
= 0x20000,
177 DOCHOSTUIFLAG_THEME
= 0x40000,
178 DOCHOSTUIFLAG_NOTHEME
= 0x80000,
179 DOCHOSTUIFLAG_NOPICS
= 0x100000,
180 DOCHOSTUIFLAG_NO3DOUTERBORDER
= 0x200000,
181 DOCHOSTUIFLAG_DISABLE_EDIT_NS_FIXUP
= 0x400000,
182 DOCHOSTUIFLAG_LOCAL_MACHINE_ACCESS_CHECK
= 0x800000,
183 DOCHOSTUIFLAG_DISABLE_UNTRUSTEDPROTOCOL
= 0x1000000
186 typedef struct _tagwxDOCHOSTUIINFO
195 class wxIDocHostUIHandler
: public IUnknown
198 virtual HRESULT wxSTDCALL
ShowContextMenu(DWORD dwID
, POINT
*ppt
,
199 IUnknown
*pcmdtReserved
,
200 IDispatch
*pdispReserved
) = 0;
202 virtual HRESULT wxSTDCALL
GetHostInfo(DOCHOSTUIINFO
*pInfo
) = 0;
204 virtual HRESULT wxSTDCALL
ShowUI(DWORD dwID
,
205 IOleInPlaceActiveObject
*pActiveObject
,
206 IOleCommandTarget
*pCommandTarget
,
207 IOleInPlaceFrame
*pFrame
,
208 IOleInPlaceUIWindow
*pDoc
) = 0;
210 virtual HRESULT wxSTDCALL
HideUI(void) = 0;
212 virtual HRESULT wxSTDCALL
UpdateUI(void) = 0;
214 virtual HRESULT wxSTDCALL
EnableModeless(BOOL fEnable
) = 0;
216 virtual HRESULT wxSTDCALL
OnDocWindowActivate(BOOL fActivate
) = 0;
218 virtual HRESULT wxSTDCALL
OnFrameWindowActivate(BOOL fActivate
) = 0;
220 virtual HRESULT wxSTDCALL
ResizeBorder(LPCRECT prcBorder
,
221 IOleInPlaceUIWindow
*pUIWindow
,
222 BOOL fRameWindow
) = 0;
224 virtual HRESULT wxSTDCALL
TranslateAccelerator(LPMSG lpMsg
,
225 const GUID
*pguidCmdGroup
,
228 virtual HRESULT wxSTDCALL
GetOptionKeyPath(LPOLESTR
*pchKey
,
231 virtual HRESULT wxSTDCALL
GetDropTarget(IDropTarget
*pDropTarget
,
232 IDropTarget
**ppDropTarget
) = 0;
234 virtual HRESULT wxSTDCALL
GetExternal(IDispatch
**ppDispatch
) = 0;
236 virtual HRESULT wxSTDCALL
TranslateUrl(DWORD dwTranslate
,
238 OLECHAR
**ppchURLOut
) = 0;
240 virtual HRESULT wxSTDCALL
FilterDataObject(IDataObject
*pDO
,
241 IDataObject
**ppDORet
) = 0;
244 /* END OF MSHTMHST.H implementation */
246 struct IHTMLDocument2
;
250 class DocHostUIHandler
;
252 class WXDLLIMPEXP_WEBVIEW wxWebViewIE
: public wxWebView
258 wxWebViewIE(wxWindow
* parent
,
260 const wxString
& url
= wxWebViewDefaultURLStr
,
261 const wxPoint
& pos
= wxDefaultPosition
,
262 const wxSize
& size
= wxDefaultSize
,
264 const wxString
& name
= wxWebViewNameStr
)
266 Create(parent
, id
, url
, pos
, size
, style
, name
);
271 bool Create(wxWindow
* parent
,
273 const wxString
& url
= wxWebViewDefaultURLStr
,
274 const wxPoint
& pos
= wxDefaultPosition
,
275 const wxSize
& size
= wxDefaultSize
,
277 const wxString
& name
= wxWebViewNameStr
);
279 virtual void LoadURL(const wxString
& url
);
280 virtual void LoadHistoryItem(wxSharedPtr
<wxWebViewHistoryItem
> item
);
281 virtual wxVector
<wxSharedPtr
<wxWebViewHistoryItem
> > GetBackwardHistory();
282 virtual wxVector
<wxSharedPtr
<wxWebViewHistoryItem
> > GetForwardHistory();
284 virtual bool CanGoForward() const;
285 virtual bool CanGoBack() const;
286 virtual void GoBack();
287 virtual void GoForward();
288 virtual void ClearHistory();
289 virtual void EnableHistory(bool enable
= true);
291 virtual void Reload(wxWebViewReloadFlags flags
= wxWEB_VIEW_RELOAD_DEFAULT
);
293 virtual wxString
GetPageSource() const;
294 virtual wxString
GetPageText() const;
296 virtual bool IsBusy() const;
297 virtual wxString
GetCurrentURL() const;
298 virtual wxString
GetCurrentTitle() const;
300 virtual void SetZoomType(wxWebViewZoomType
);
301 virtual wxWebViewZoomType
GetZoomType() const;
302 virtual bool CanSetZoomType(wxWebViewZoomType
) const;
304 virtual void Print();
306 virtual void SetPage(const wxString
& html
, const wxString
& baseUrl
);
308 virtual wxWebViewZoom
GetZoom() const;
309 virtual void SetZoom(wxWebViewZoom zoom
);
311 //Clipboard functions
312 virtual bool CanCut() const;
313 virtual bool CanCopy() const;
314 virtual bool CanPaste() const;
317 virtual void Paste();
319 //Undo / redo functionality
320 virtual bool CanUndo() const;
321 virtual bool CanRedo() const;
326 virtual void SetEditable(bool enable
= true);
327 virtual bool IsEditable() const;
330 virtual void SelectAll();
331 virtual bool HasSelection() const;
332 virtual void DeleteSelection();
333 virtual wxString
GetSelectedText() const;
334 virtual wxString
GetSelectedSource() const;
335 virtual void ClearSelection();
337 virtual void RunScript(const wxString
& javascript
);
339 //Virtual Filesystem Support
340 virtual void RegisterHandler(wxSharedPtr
<wxWebViewHandler
> handler
);
342 // ---- IE-specific methods
344 // FIXME: I seem to be able to access remote webpages even in offline mode...
345 bool IsOfflineMode();
346 void SetOfflineMode(bool offline
);
348 wxWebViewZoom
GetIETextZoom() const;
349 void SetIETextZoom(wxWebViewZoom level
);
351 wxWebViewZoom
GetIEOpticalZoom() const;
352 void SetIEOpticalZoom(wxWebViewZoom level
);
354 void onActiveXEvent(wxActiveXEvent
& evt
);
355 void onEraseBg(wxEraseEvent
&) {}
357 DECLARE_EVENT_TABLE();
360 wxIEContainer
* m_container
;
361 wxAutomationObject m_ie
;
362 IWebBrowser2
* m_webBrowser
;
364 wxCOMPtr
<DocHostUIHandler
> m_uiHandler
;
366 //We store the current zoom type;
367 wxWebViewZoomType m_zoomType
;
369 /** The "Busy" property of IWebBrowser2 does not always return busy when
370 * we'd want it to; this variable may be set to true in cases where the
371 * Busy property is false but should be true.
374 //We manage our own history, the history list contains the history items
375 //which are added as documentcomplete events arrive, unless we are loading
376 //an item from the history. The position is stored as an int, and reflects
377 //where we are in the history list.
378 wxVector
<wxSharedPtr
<wxWebViewHistoryItem
> > m_historyList
;
379 wxVector
<ClassFactory
*> m_factories
;
380 int m_historyPosition
;
381 bool m_historyLoadingFromList
;
382 bool m_historyEnabled
;
384 //Generic helper functions for IHtmlDocument commands
385 bool CanExecCommand(wxString command
) const;
386 void ExecCommand(wxString command
);
387 wxCOMPtr
<IHTMLDocument2
> GetDocument() const;
388 //Toggles control features see INTERNETFEATURELIST for values.
389 bool EnableControlFeature(long flag
, bool enable
= true);
391 wxDECLARE_DYNAMIC_CLASS(wxWebViewIE
);
394 class VirtualProtocol
: public wxIInternetProtocol
397 wxIInternetProtocolSink
* m_protocolSink
;
402 wxSharedPtr
<wxWebViewHandler
> m_handler
;
405 VirtualProtocol(wxSharedPtr
<wxWebViewHandler
> handler
);
406 ~VirtualProtocol() {}
409 DECLARE_IUNKNOWN_METHODS
;
411 //IInternetProtocolRoot
412 HRESULT STDMETHODCALLTYPE
Abort(HRESULT
WXUNUSED(hrReason
),
413 DWORD
WXUNUSED(dwOptions
))
414 { return E_NOTIMPL
; }
415 HRESULT STDMETHODCALLTYPE
Continue(wxPROTOCOLDATA
*WXUNUSED(pProtocolData
))
417 HRESULT STDMETHODCALLTYPE
Resume() { return S_OK
; }
418 HRESULT STDMETHODCALLTYPE
Start(LPCWSTR szUrl
,
419 wxIInternetProtocolSink
*pOIProtSink
,
420 wxIInternetBindInfo
*pOIBindInfo
,
422 HANDLE_PTR dwReserved
);
423 HRESULT STDMETHODCALLTYPE
Suspend() { return S_OK
; }
424 HRESULT STDMETHODCALLTYPE
Terminate(DWORD
WXUNUSED(dwOptions
)) { return S_OK
; }
427 HRESULT STDMETHODCALLTYPE
LockRequest(DWORD
WXUNUSED(dwOptions
))
429 HRESULT STDMETHODCALLTYPE
Read(void *pv
, ULONG cb
, ULONG
*pcbRead
);
430 HRESULT STDMETHODCALLTYPE
Seek(LARGE_INTEGER
WXUNUSED(dlibMove
),
431 DWORD
WXUNUSED(dwOrigin
),
432 ULARGE_INTEGER
* WXUNUSED(plibNewPosition
))
434 HRESULT STDMETHODCALLTYPE
UnlockRequest() { return S_OK
; }
437 class ClassFactory
: public IClassFactory
440 ClassFactory(wxSharedPtr
<wxWebViewHandler
> handler
) : m_handler(handler
) {}
443 HRESULT STDMETHODCALLTYPE
CreateInstance(IUnknown
* pUnkOuter
,
444 REFIID riid
, void** ppvObject
);
445 HRESULT STDMETHODCALLTYPE
LockServer(BOOL fLock
);
448 DECLARE_IUNKNOWN_METHODS
;
451 wxSharedPtr
<wxWebViewHandler
> m_handler
;
454 class wxIEContainer
: public wxActiveXContainer
457 wxIEContainer(wxWindow
*parent
, REFIID iid
, IUnknown
*pUnk
, DocHostUIHandler
* uiHandler
= NULL
);
458 virtual ~wxIEContainer();
459 virtual bool QueryClientSiteInterface(REFIID iid
, void **_interface
, const char *&desc
);
461 DocHostUIHandler
* m_uiHandler
;
464 class DocHostUIHandler
: public wxIDocHostUIHandler
467 DocHostUIHandler() {};
468 ~DocHostUIHandler() {};
469 virtual HRESULT wxSTDCALL
ShowContextMenu(DWORD dwID
, POINT
*ppt
,
470 IUnknown
*pcmdtReserved
,
471 IDispatch
*pdispReserved
);
473 virtual HRESULT wxSTDCALL
GetHostInfo(DOCHOSTUIINFO
*pInfo
);
475 virtual HRESULT wxSTDCALL
ShowUI(DWORD dwID
,
476 IOleInPlaceActiveObject
*pActiveObject
,
477 IOleCommandTarget
*pCommandTarget
,
478 IOleInPlaceFrame
*pFrame
,
479 IOleInPlaceUIWindow
*pDoc
);
481 virtual HRESULT wxSTDCALL
HideUI(void);
483 virtual HRESULT wxSTDCALL
UpdateUI(void);
485 virtual HRESULT wxSTDCALL
EnableModeless(BOOL fEnable
);
487 virtual HRESULT wxSTDCALL
OnDocWindowActivate(BOOL fActivate
);
489 virtual HRESULT wxSTDCALL
OnFrameWindowActivate(BOOL fActivate
);
491 virtual HRESULT wxSTDCALL
ResizeBorder(LPCRECT prcBorder
,
492 IOleInPlaceUIWindow
*pUIWindow
,
495 virtual HRESULT wxSTDCALL
TranslateAccelerator(LPMSG lpMsg
,
496 const GUID
*pguidCmdGroup
,
499 virtual HRESULT wxSTDCALL
GetOptionKeyPath(LPOLESTR
*pchKey
,
502 virtual HRESULT wxSTDCALL
GetDropTarget(IDropTarget
*pDropTarget
,
503 IDropTarget
**ppDropTarget
);
505 virtual HRESULT wxSTDCALL
GetExternal(IDispatch
**ppDispatch
);
507 virtual HRESULT wxSTDCALL
TranslateUrl(DWORD dwTranslate
,
509 OLECHAR
**ppchURLOut
);
511 virtual HRESULT wxSTDCALL
FilterDataObject(IDataObject
*pDO
,
512 IDataObject
**ppDORet
);
514 DECLARE_IUNKNOWN_METHODS
;
517 #endif // wxUSE_WEBVIEW && wxUSE_WEBVIEW_IE && defined(__WXMSW__)
519 #endif // wxWebViewIE_H