include/wx/osx/webview_webkit.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        include/wx/osx/webkit.h
   3 // Purpose:     wxWebViewWebKit - embeddable web kit control,
   4 //                             OS X implementation of web view component
   5 // Author:      Jethro Grassie / Kevin Ollivier / Marianne Gagnon
   6 // Modified by:
   7 // Created:     2004-4-16
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) Jethro Grassie / Kevin Ollivier / Marianne Gagnon
  10 // Licence:     wxWindows licence
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 #ifndef _WX_WEBKIT_H
  14 #define _WX_WEBKIT_H
  15
  16 #include "wx/setup.h"
  17
  18 #if wxUSE_WEBKIT && (defined(__WXMAC__) || defined(__WXCOCOA__))
  19
  20 #include "wx/control.h"
  21 #include "wx/webview.h"
  22
  23 // ----------------------------------------------------------------------------
  24 // Web Kit Control
  25 // ----------------------------------------------------------------------------
  26
  27 class WXDLLIMPEXP_WEB wxWebViewWebKit : public wxWebView
  28 {
  29 public:
  30     wxDECLARE_DYNAMIC_CLASS(wxWebViewWebKit);
  31
  32     wxWebViewWebKit() {}
  33     wxWebViewWebKit(wxWindow *parent,
  34                     wxWindowID winID = wxID_ANY,
  35                     const wxString& strURL = wxWebViewDefaultURLStr,
  36                     const wxPoint& pos = wxDefaultPosition,
  37                     const wxSize& size = wxDefaultSize, long style = 0,
  38                     const wxString& name = wxWebViewNameStr)
  39     {
  40         Create(parent, winID, strURL, pos, size, style, name);
  41     }
  42     bool Create(wxWindow *parent,
  43                 wxWindowID winID = wxID_ANY,
  44                 const wxString& strURL = wxWebViewDefaultURLStr,
  45                 const wxPoint& pos = wxDefaultPosition,
  46                 const wxSize& size = wxDefaultSize, long style = 0,
  47                 const wxString& name = wxWebViewNameStr);
  48     virtual ~wxWebViewWebKit();
  49
  50     void InternalLoadURL(const wxString &url);
  51
  52     virtual bool CanGoBack();
  53     virtual bool CanGoForward();
  54     virtual void GoBack();
  55     virtual void GoForward();
  56     virtual void Reload(wxWebViewReloadFlags flags = wxWEB_VIEW_RELOAD_DEFAULT);
  57     virtual void Stop();
  58     virtual wxString GetPageSource();
  59     virtual void SetPageTitle(const wxString& title) { m_pageTitle = title; }
  60     virtual wxString GetPageTitle(){ return m_pageTitle; }
  61
  62     virtual void SetPage(const wxString& html, const wxString& baseUrl);
  63
  64     virtual void Print();
  65
  66     virtual void LoadUrl(const wxString& url);
  67     virtual wxString GetCurrentURL();
  68     virtual wxString GetCurrentTitle();
  69     virtual wxWebViewZoom GetZoom();
  70     virtual void SetZoom(wxWebViewZoom zoom);
  71
  72     virtual void SetZoomType(wxWebViewZoomType zoomType);
  73     virtual wxWebViewZoomType GetZoomType() const;
  74     virtual bool CanSetZoomType(wxWebViewZoomType type) const;
  75
  76     virtual bool IsBusy() { return m_busy; }
  77
  78     //History functions
  79     virtual void ClearHistory() {}
  80     virtual void EnableHistory(bool enable = true) {}
  81     virtual wxVector<wxSharedPtr<wxWebHistoryItem> > GetBackwardHistory()
  82             { return wxVector<wxSharedPtr<wxWebHistoryItem> >() }
  83     virtual wxVector<wxSharedPtr<wxWebHistoryItem> > GetForwardHistory()
  84             { return wxVector<wxSharedPtr<wxWebHistoryItem> >() }
  85     virtual void LoadHistoryItem(wxSharedPtr<wxWebHistoryItem> item) {}
  86
  87     //Undo / redo functionality
  88     virtual bool CanUndo() { return false; }
  89     virtual bool CanRedo() { return false; }
  90     virtual void Undo() {}
  91     virtual void Redo() {}
  92
  93     //Clipboard functions
  94     virtual bool CanCut() { return false; }
  95     virtual bool CanCopy() { return false; }
  96     virtual bool CanPaste() { return false; }
  97     virtual void Cut();
  98     virtual void Copy();
  99     virtual void Paste();
 100
 101     // ---- methods not from the parent (common) interface
 102     wxString GetSelectedText();
 103
 104     wxString RunScript(const wxString& javascript);
 105
 106     bool  CanGetPageSource();
 107
 108     void  SetScrollPos(int pos);
 109     int   GetScrollPos();
 110
 111     void  MakeEditable(bool enable = true);
 112     bool  IsEditable();
 113
 114     wxString GetSelection();
 115
 116     bool  CanIncreaseTextSize();
 117     void  IncreaseTextSize();
 118     bool  CanDecreaseTextSize();
 119     void  DecreaseTextSize();
 120
 121     float GetWebkitZoom();
 122     void  SetWebkitZoom(float zoom);
 123
 124     // don't hide base class virtuals
 125     virtual void SetScrollPos( int orient, int pos, bool refresh = true )
 126         { return wxControl::SetScrollPos(orient, pos, refresh); }
 127     virtual int GetScrollPos( int orient ) const
 128         { return wxControl::GetScrollPos(orient); }
 129
 130     //we need to resize the webview when the control size changes
 131     void OnSize(wxSizeEvent &event);
 132     void OnMove(wxMoveEvent &event);
 133     void OnMouseEvents(wxMouseEvent &event);
 134
 135     bool m_busy;
 136
 137 protected:
 138     DECLARE_EVENT_TABLE()
 139     void MacVisibilityChanged();
 140
 141 private:
 142     wxWindow *m_parent;
 143     wxWindowID m_windowID;
 144     wxString m_pageTitle;
 145
 146     struct objc_object *m_webView;
 147
 148     // we may use this later to setup our own mouse events,
 149     // so leave it in for now.
 150     void* m_webKitCtrlEventHandler;
 151     //It should be WebView*, but WebView is an Objective-C class
 152     //TODO: look into using DECLARE_WXCOCOA_OBJC_CLASS rather than this.
 153 };
 154
 155 #endif // wxUSE_WEBKIT
 156
 157 #endif // _WX_WEBKIT_H_