d2f125aa35
No real changes, just avoid the unnecessary copying and also make the signatures more consistent by adding the apparently forgotten "&" in a couple of places. See #15893. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@75657 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
305 lines
10 KiB
C++
305 lines
10 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: webview.h
|
|
// Purpose: Common interface and events for web view component
|
|
// Author: Marianne Gagnon
|
|
// Copyright: (c) 2010 Marianne Gagnon, 2011 Steven Lamerton
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_WEBVIEW_H_
|
|
#define _WX_WEBVIEW_H_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_WEBVIEW
|
|
|
|
#include "wx/control.h"
|
|
#include "wx/event.h"
|
|
#include "wx/sstream.h"
|
|
#include "wx/sharedptr.h"
|
|
#include "wx/vector.h"
|
|
|
|
#if defined(__WXOSX__)
|
|
#include "wx/osx/webviewhistoryitem_webkit.h"
|
|
#elif defined(__WXGTK__)
|
|
#include "wx/gtk/webviewhistoryitem_webkit.h"
|
|
#elif defined(__WXMSW__)
|
|
#include "wx/msw/webviewhistoryitem_ie.h"
|
|
#else
|
|
#error "wxWebView not implemented on this platform."
|
|
#endif
|
|
|
|
class wxFSFile;
|
|
class wxFileSystem;
|
|
class wxWebView;
|
|
|
|
enum wxWebViewZoom
|
|
{
|
|
wxWEBVIEW_ZOOM_TINY,
|
|
wxWEBVIEW_ZOOM_SMALL,
|
|
wxWEBVIEW_ZOOM_MEDIUM,
|
|
wxWEBVIEW_ZOOM_LARGE,
|
|
wxWEBVIEW_ZOOM_LARGEST
|
|
};
|
|
|
|
enum wxWebViewZoomType
|
|
{
|
|
//Scales entire page, including images
|
|
wxWEBVIEW_ZOOM_TYPE_LAYOUT,
|
|
wxWEBVIEW_ZOOM_TYPE_TEXT
|
|
};
|
|
|
|
enum wxWebViewNavigationError
|
|
{
|
|
wxWEBVIEW_NAV_ERR_CONNECTION,
|
|
wxWEBVIEW_NAV_ERR_CERTIFICATE,
|
|
wxWEBVIEW_NAV_ERR_AUTH,
|
|
wxWEBVIEW_NAV_ERR_SECURITY,
|
|
wxWEBVIEW_NAV_ERR_NOT_FOUND,
|
|
wxWEBVIEW_NAV_ERR_REQUEST,
|
|
wxWEBVIEW_NAV_ERR_USER_CANCELLED,
|
|
wxWEBVIEW_NAV_ERR_OTHER
|
|
};
|
|
|
|
enum wxWebViewReloadFlags
|
|
{
|
|
//Default, may access cache
|
|
wxWEBVIEW_RELOAD_DEFAULT,
|
|
wxWEBVIEW_RELOAD_NO_CACHE
|
|
};
|
|
|
|
enum wxWebViewFindFlags
|
|
{
|
|
wxWEBVIEW_FIND_WRAP = 0x0001,
|
|
wxWEBVIEW_FIND_ENTIRE_WORD = 0x0002,
|
|
wxWEBVIEW_FIND_MATCH_CASE = 0x0004,
|
|
wxWEBVIEW_FIND_HIGHLIGHT_RESULT = 0x0008,
|
|
wxWEBVIEW_FIND_BACKWARDS = 0x0010,
|
|
wxWEBVIEW_FIND_DEFAULT = 0
|
|
};
|
|
|
|
//Base class for custom scheme handlers
|
|
class WXDLLIMPEXP_WEBVIEW wxWebViewHandler
|
|
{
|
|
public:
|
|
wxWebViewHandler(const wxString& scheme) : m_scheme(scheme) {}
|
|
virtual ~wxWebViewHandler() {}
|
|
virtual wxString GetName() const { return m_scheme; }
|
|
virtual wxFSFile* GetFile(const wxString &uri) = 0;
|
|
private:
|
|
wxString m_scheme;
|
|
};
|
|
|
|
extern WXDLLIMPEXP_DATA_WEBVIEW(const char) wxWebViewNameStr[];
|
|
extern WXDLLIMPEXP_DATA_WEBVIEW(const char) wxWebViewDefaultURLStr[];
|
|
extern WXDLLIMPEXP_DATA_WEBVIEW(const char) wxWebViewBackendDefault[];
|
|
extern WXDLLIMPEXP_DATA_WEBVIEW(const char) wxWebViewBackendIE[];
|
|
extern WXDLLIMPEXP_DATA_WEBVIEW(const char) wxWebViewBackendWebKit[];
|
|
|
|
class WXDLLIMPEXP_WEBVIEW wxWebViewFactory : public wxObject
|
|
{
|
|
public:
|
|
virtual wxWebView* Create() = 0;
|
|
virtual wxWebView* Create(wxWindow* parent,
|
|
wxWindowID id,
|
|
const wxString& url = wxWebViewDefaultURLStr,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxWebViewNameStr) = 0;
|
|
};
|
|
|
|
WX_DECLARE_STRING_HASH_MAP(wxSharedPtr<wxWebViewFactory>, wxStringWebViewFactoryMap);
|
|
|
|
class WXDLLIMPEXP_WEBVIEW wxWebView : public wxControl
|
|
{
|
|
public:
|
|
wxWebView()
|
|
{
|
|
m_showMenu = true;
|
|
}
|
|
|
|
virtual ~wxWebView() {}
|
|
|
|
virtual bool Create(wxWindow* parent,
|
|
wxWindowID id,
|
|
const wxString& url = wxWebViewDefaultURLStr,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxWebViewNameStr) = 0;
|
|
|
|
// Factory methods allowing the use of custom factories registered with
|
|
// RegisterFactory
|
|
static wxWebView* New(const wxString& backend = wxWebViewBackendDefault);
|
|
static wxWebView* New(wxWindow* parent,
|
|
wxWindowID id,
|
|
const wxString& url = wxWebViewDefaultURLStr,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
const wxString& backend = wxWebViewBackendDefault,
|
|
long style = 0,
|
|
const wxString& name = wxWebViewNameStr);
|
|
|
|
static void RegisterFactory(const wxString& backend,
|
|
wxSharedPtr<wxWebViewFactory> factory);
|
|
|
|
// General methods
|
|
virtual void EnableContextMenu(bool enable = true)
|
|
{
|
|
m_showMenu = enable;
|
|
}
|
|
virtual wxString GetCurrentTitle() const = 0;
|
|
virtual wxString GetCurrentURL() const = 0;
|
|
// TODO: handle choosing a frame when calling GetPageSource()?
|
|
virtual wxString GetPageSource() const = 0;
|
|
virtual wxString GetPageText() const = 0;
|
|
virtual bool IsBusy() const = 0;
|
|
virtual bool IsContextMenuEnabled() const { return m_showMenu; }
|
|
virtual bool IsEditable() const = 0;
|
|
virtual void LoadURL(const wxString& url) = 0;
|
|
virtual void Print() = 0;
|
|
virtual void RegisterHandler(wxSharedPtr<wxWebViewHandler> handler) = 0;
|
|
virtual void Reload(wxWebViewReloadFlags flags = wxWEBVIEW_RELOAD_DEFAULT) = 0;
|
|
virtual void RunScript(const wxString& javascript) = 0;
|
|
virtual void SetEditable(bool enable = true) = 0;
|
|
void SetPage(const wxString& html, const wxString& baseUrl)
|
|
{
|
|
DoSetPage(html, baseUrl);
|
|
}
|
|
void SetPage(wxInputStream& html, wxString baseUrl)
|
|
{
|
|
wxStringOutputStream stream;
|
|
stream.Write(html);
|
|
DoSetPage(stream.GetString(), baseUrl);
|
|
}
|
|
virtual void Stop() = 0;
|
|
|
|
//History
|
|
virtual bool CanGoBack() const = 0;
|
|
virtual bool CanGoForward() const = 0;
|
|
virtual void GoBack() = 0;
|
|
virtual void GoForward() = 0;
|
|
virtual void ClearHistory() = 0;
|
|
virtual void EnableHistory(bool enable = true) = 0;
|
|
virtual wxVector<wxSharedPtr<wxWebViewHistoryItem> > GetBackwardHistory() = 0;
|
|
virtual wxVector<wxSharedPtr<wxWebViewHistoryItem> > GetForwardHistory() = 0;
|
|
virtual void LoadHistoryItem(wxSharedPtr<wxWebViewHistoryItem> item) = 0;
|
|
|
|
//Zoom
|
|
virtual bool CanSetZoomType(wxWebViewZoomType type) const = 0;
|
|
virtual wxWebViewZoom GetZoom() const = 0;
|
|
virtual wxWebViewZoomType GetZoomType() const = 0;
|
|
virtual void SetZoom(wxWebViewZoom zoom) = 0;
|
|
virtual void SetZoomType(wxWebViewZoomType zoomType) = 0;
|
|
|
|
//Selection
|
|
virtual void SelectAll() = 0;
|
|
virtual bool HasSelection() const = 0;
|
|
virtual void DeleteSelection() = 0;
|
|
virtual wxString GetSelectedText() const = 0;
|
|
virtual wxString GetSelectedSource() const = 0;
|
|
virtual void ClearSelection() = 0;
|
|
|
|
//Clipboard functions
|
|
virtual bool CanCut() const = 0;
|
|
virtual bool CanCopy() const = 0;
|
|
virtual bool CanPaste() const = 0;
|
|
virtual void Cut() = 0;
|
|
virtual void Copy() = 0;
|
|
virtual void Paste() = 0;
|
|
|
|
//Undo / redo functionality
|
|
virtual bool CanUndo() const = 0;
|
|
virtual bool CanRedo() const = 0;
|
|
virtual void Undo() = 0;
|
|
virtual void Redo() = 0;
|
|
|
|
//Get the pointer to the underlying native engine.
|
|
virtual void* GetNativeBackend() const = 0;
|
|
//Find function
|
|
virtual long Find(const wxString& text, int flags = wxWEBVIEW_FIND_DEFAULT) = 0;
|
|
|
|
protected:
|
|
virtual void DoSetPage(const wxString& html, const wxString& baseUrl) = 0;
|
|
|
|
private:
|
|
static void InitFactoryMap();
|
|
static wxStringWebViewFactoryMap::iterator FindFactory(const wxString &backend);
|
|
|
|
bool m_showMenu;
|
|
static wxStringWebViewFactoryMap m_factoryMap;
|
|
|
|
wxDECLARE_ABSTRACT_CLASS(wxWebView);
|
|
};
|
|
|
|
class WXDLLIMPEXP_WEBVIEW wxWebViewEvent : public wxNotifyEvent
|
|
{
|
|
public:
|
|
wxWebViewEvent() {}
|
|
wxWebViewEvent(wxEventType type, int id, const wxString& url,
|
|
const wxString& target)
|
|
: wxNotifyEvent(type, id), m_url(url), m_target(target)
|
|
{}
|
|
|
|
|
|
const wxString& GetURL() const { return m_url; }
|
|
const wxString& GetTarget() const { return m_target; }
|
|
|
|
virtual wxEvent* Clone() const { return new wxWebViewEvent(*this); }
|
|
private:
|
|
wxString m_url;
|
|
wxString m_target;
|
|
|
|
wxDECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxWebViewEvent);
|
|
};
|
|
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_NAVIGATING, wxWebViewEvent );
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_NAVIGATED, wxWebViewEvent );
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_LOADED, wxWebViewEvent );
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_ERROR, wxWebViewEvent );
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_NEWWINDOW, wxWebViewEvent );
|
|
wxDECLARE_EXPORTED_EVENT( WXDLLIMPEXP_WEBVIEW, wxEVT_WEBVIEW_TITLE_CHANGED, wxWebViewEvent );
|
|
|
|
typedef void (wxEvtHandler::*wxWebViewEventFunction)
|
|
(wxWebViewEvent&);
|
|
|
|
#define wxWebViewEventHandler(func) \
|
|
wxEVENT_HANDLER_CAST(wxWebViewEventFunction, func)
|
|
|
|
#define EVT_WEBVIEW_NAVIGATING(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_NAVIGATING, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
#define EVT_WEBVIEW_NAVIGATED(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_NAVIGATED, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
#define EVT_WEBVIEW_LOADED(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_LOADED, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
#define EVT_WEBVIEW_ERROR(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_ERROR, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
#define EVT_WEBVIEW_NEWWINDOW(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_NEWWINDOW, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
#define EVT_WEBVIEW_TITLE_CHANGED(id, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_WEBVIEW_TITLE_CHANGED, id, \
|
|
wxWebViewEventHandler(fn))
|
|
|
|
// old wxEVT_COMMAND_* constants
|
|
#define wxEVT_COMMAND_WEBVIEW_NAVIGATING wxEVT_WEBVIEW_NAVIGATING
|
|
#define wxEVT_COMMAND_WEBVIEW_NAVIGATED wxEVT_WEBVIEW_NAVIGATED
|
|
#define wxEVT_COMMAND_WEBVIEW_LOADED wxEVT_WEBVIEW_LOADED
|
|
#define wxEVT_COMMAND_WEBVIEW_ERROR wxEVT_WEBVIEW_ERROR
|
|
#define wxEVT_COMMAND_WEBVIEW_NEWWINDOW wxEVT_WEBVIEW_NEWWINDOW
|
|
#define wxEVT_COMMAND_WEBVIEW_TITLE_CHANGED wxEVT_WEBVIEW_TITLE_CHANGED
|
|
|
|
#endif // wxUSE_WEBVIEW
|
|
|
|
#endif // _WX_WEBVIEW_H_
|