Update wxWebFileHandler to handle paths with fragments correctly, some backends pass...

[wxWidgets.git] / interface / wx / webview.h

diff --git a/interface/wx/webview.h b/interface/wx/webview.h
index 4e7ec449831f40253fa8031ba2acb07619a1c5ae..cf5b9bd75a8d9965da3fe6fe5b7e80b859ddc3fb 100644 (file)
--- a/interface/wx/webview.h
+++ b/interface/wx/webview.h
@@ -155,8 +155,11 @@ public:
        precise error message/code.
     @event{EVT_WEB_VIEW_NEWWINDOW(id, func)}
        Process a @c wxEVT_COMMAND_WEB_VIEW_NEWWINDOW event, generated when a new
-       window is created. This event may be vetoed to prevent a new window showing,
-       for example if you want to open the url in the existing window or a new tab.
+       window is created. You must handle this event if you want anything to 
+       happen, for example to load the page in a new window or tab.
+    @event{EVT_WEB_VIEW_TITLE_CHANGED(id, func)}
+       Process a @c wxEVT_COMMAND_WEB_VIEW_TITLE_CHANGED event, generated when 
+       the page title changes. Use GetString to get the title.
     @endEventTable
    
     @library{wxweb}
@@ -519,8 +522,11 @@ public:
        precise error message/code.
     @event{EVT_WEB_VIEW_NEWWINDOW(id, func)}
        Process a @c wxEVT_COMMAND_WEB_VIEW_NEWWINDOW event, generated when a new
-       window is created. This event may be vetoed to prevent a new window showing,
-       for example if you want to open the url in the existing window or a new tab.
+       window is created. You must handle this event if you want anything to 
+       happen, for example to load the page in a new window or tab.
+    @event{EVT_WEB_VIEW_TITLE_CHANGED(id, func)}
+       Process a @c wxEVT_COMMAND_WEB_VIEW_TITLE_CHANGED event, generated when 
+       the page title changes. Use GetString to get the title.
     @endEventTable
 
     @library{wxweb}
@@ -534,23 +540,24 @@ public:
     wxWebNavigationEvent();
     wxWebNavigationEvent(wxEventType type, int id, const wxString href,
                          const wxString target, bool canVeto);
+
     /**
-        Get the URL being visited
+        Get the name of the target frame which the url of this event
+        has been or will be loaded into. This may return an emptry string
+        if the frame is not avaliable.
     */
-    const wxString& GetHref() const { return m_href; }
+    const wxString& GetTarget() const;
 
     /**
-        Get the target (frame or window) in which the URL that caused this event
-        is viewed, or an empty string if not available.
+        Get the URL being visited
     */
-    const wxString& GetTarget() const;
+    const wxString& GetURL() const;
 
     virtual wxEvent* Clone() const;
 
     /** 
         Get whether this event may be vetoed (stopped/prevented). Only
-        meaningful for events fired before navigation takes place or new 
-        window events.
+        meaningful for events fired before navigation takes place.
      */
     bool CanVeto() const;
 
@@ -562,8 +569,7 @@ public:
 
     /** 
         Veto (prevent/stop) this event. Only meaningful for events fired
-        before navigation takes place or new window events. Only valid 
-        if CanVeto() returned true.
+        before navigation takes place. Only valid if CanVeto() returned true.
      */
     void Veto();
 };
\ No newline at end of file