MYcopystring is not required anymore when compat2.8 is off

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

diff --git a/interface/wx/hyperlink.h b/interface/wx/hyperlink.h
index bd62fe8fd952d3c54b33d6a7b578b2f34c468efd..115db369cbaf0e5257dd86b1a3c26f5eb8bffcd5 100644 (file)
--- a/interface/wx/hyperlink.h
+++ b/interface/wx/hyperlink.h
@@ -9,11 +9,15 @@
 /**
     @class wxHyperlinkEvent
 
 /**
     @class wxHyperlinkEvent
 

-    This event class is used for the events generated by
-    wxHyperlinkCtrl.
+    This event class is used for the events generated by wxHyperlinkCtrl.
+
+    @beginEventTable{wxHyperlinkEvent}
+    @event{EVT_HYPERLINK(id, func)}
+        User clicked on an hyperlink.
+    @endEventTable

 
     @library{wxadv}
 
     @library{wxadv}

-    @category{FIXME}
+    @category{events}

 */
 class wxHyperlinkEvent : public wxCommandEvent
 {
 */
 class wxHyperlinkEvent : public wxCommandEvent
 {


@@ -21,8 +25,7 @@ public:
     /**
         The constructor is not normally used by the user code.
     */
     /**
         The constructor is not normally used by the user code.
     */

-    wxHyperlinkEvent(wxObject* generator, int id,
-                     const wxString& url);
+    wxHyperlinkEvent(wxObject* generator, int id, const wxString& url);

 
     /**
         Returns the URL of the hyperlink where the user has just clicked.
 
     /**
         Returns the URL of the hyperlink where the user has just clicked.


@@ -41,15 +44,15 @@ public:
     @class wxHyperlinkCtrl
 
     This class shows a static text element which links to an URL.
     @class wxHyperlinkCtrl
 
     This class shows a static text element which links to an URL.

-    Appearance and behaviour is completely customizable. In fact, when the user
-    clicks on the hyperlink, a wxHyperlinkEvent is
-    sent but if that event is not handled (or it's skipped; see
-    wxEvent::Skip), then a call to
-    wxLaunchDefaultBrowser() is done with the
-    hyperlink's URL.
+    Appearance and behaviour is completely customizable.
+
+    In fact, when the user clicks on the hyperlink, a wxHyperlinkEvent is
+    sent but if that event is not handled (or it's skipped; see wxEvent::Skip),
+    then a call to wxLaunchDefaultBrowser() is done with the hyperlink's URL.

 
     Note that standard wxWindow functions like wxWindow::SetBackgroundColour,
 
     Note that standard wxWindow functions like wxWindow::SetBackgroundColour,

-    wxWindow::SetFont, wxWindow::SetCursor, wxWindow::SetLabel can be used to customize appearance of the hyperlink.
+    wxWindow::SetFont, wxWindow::SetCursor, wxWindow::SetLabel can be used to
+    customize appearance of the hyperlink.

 
     @beginStyleTable
     @style{wxHL_ALIGN_LEFT}
 
     @beginStyleTable
     @style{wxHL_ALIGN_LEFT}


@@ -68,9 +71,17 @@ public:
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable
 
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable
 

+    @beginEventTable{wxHyperlinkEvent}
+    @event{EVT_HYPERLINK(id, func)}
+        The hyperlink was (left) clicked. If this event is not handled in user's
+        code (or it's skipped; see wxEvent::Skip), then a call to wxLaunchDefaultBrowser
+        is done with the hyperlink's URL.
+    @endEventTable
+
+

     @library{wxadv}
     @category{ctrl}
     @library{wxadv}
     @category{ctrl}

-    <!-- @appearance{hyperlinkctrl.png} -->
+    @appearance{hyperlinkctrl.png}

 
     @see wxURL, wxHyperlinkEvent
 */
 
     @see wxURL, wxHyperlinkEvent
 */


@@ -102,40 +113,35 @@ public:
         @param pos
             Window position.
         @param size
         @param pos
             Window position.
         @param size

-            Window size. If the wxDefaultSize is specified then the window is sized
-            appropriately.
+            Window size.
+            If the wxDefaultSize is specified then the window is sized appropriately.

         @param style
             Window style. See wxHyperlinkCtrl.
         @param style
             Window style. See wxHyperlinkCtrl.

-        @param validator
-            Window validator.

         @param name
             Window name.
     */
         @param name
             Window name.
     */

-    bool Create(wxWindow* parent, wxWindowID id,
-                const wxString& label,
-                const wxString& url,
-                const wxPoint& pos = wxDefaultPosition,
+    bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
+                const wxString& url, const wxPoint& pos = wxDefaultPosition,

                 const wxSize& size = wxDefaultSize,
                 long style = wxHL_DEFAULT_STYLE,
                 const wxSize& size = wxDefaultSize,
                 long style = wxHL_DEFAULT_STYLE,

-                const wxString& name = "hyperlink");
+                const wxString& name = wxHyperlinkCtrlNameStr);

 
     /**
         Returns the colour used to print the label of the hyperlink when the mouse is
         over the control.
     */
 
     /**
         Returns the colour used to print the label of the hyperlink when the mouse is
         over the control.
     */

-    wxColour GetHoverColour() const;
+    virtual wxColour GetHoverColour() const;

 
     /**
         Returns the colour used to print the label when the link has never been clicked
 
     /**
         Returns the colour used to print the label when the link has never been clicked

-        before
-        (i.e. the link has not been @e visited) and the mouse is not over the control.
+        before (i.e. the link has not been @e visited) and the mouse is not over the control.

     */
     */

-    wxColour GetNormalColour() const;
+    virtual wxColour GetNormalColour() const;

 
     /**
         Returns the URL associated with the hyperlink.
     */
 
     /**
         Returns the URL associated with the hyperlink.
     */

-    wxString GetURL() const;
+    virtual wxString GetURL() const;

 
     /**
         Returns @true if the hyperlink has already been clicked by the user at least
 
     /**
         Returns @true if the hyperlink has already been clicked by the user at least


@@ -145,29 +151,27 @@ public:
 
     /**
         Returns the colour used to print the label when the mouse is not over the
 
     /**
         Returns the colour used to print the label when the mouse is not over the

-        control
-        and the link has already been clicked before (i.e. the link has been @e
-        visited).
+        control and the link has already been clicked before (i.e. the link has
+        been @e visited).

     */
     */

-    wxColour GetVisitedColour() const;
+    virtual wxColour GetVisitedColour() const;

 
     /**
         Sets the colour used to print the label of the hyperlink when the mouse is over
         the control.
     */
 
     /**
         Sets the colour used to print the label of the hyperlink when the mouse is over
         the control.
     */

-    void SetHoverColour(const wxColour& colour);
+    virtual void SetHoverColour(const wxColour& colour);

 
     /**
 
     /**

-        Sets the colour used to print the label when the link has never been clicked
-        before
+        Sets the colour used to print the label when the link has never been clicked before

         (i.e. the link has not been @e visited) and the mouse is not over the control.
     */
         (i.e. the link has not been @e visited) and the mouse is not over the control.
     */

-    void SetNormalColour(const wxColour& colour);
+    virtual void SetNormalColour(const wxColour& colour);

 
     /**
         Sets the URL associated with the hyperlink.
     */
 
     /**
         Sets the URL associated with the hyperlink.
     */

-    void SetURL(const wxString& url);
+    virtual void SetURL(const wxString& url);

 
     /**
         Marks the hyperlink as visited (see wxHyperlinkCtrl::SetVisitedColour).
 
     /**
         Marks the hyperlink as visited (see wxHyperlinkCtrl::SetVisitedColour).


@@ -176,9 +180,8 @@ public:
 
     /**
         Sets the colour used to print the label when the mouse is not over the control
 
     /**
         Sets the colour used to print the label when the mouse is not over the control

-        and the link has already been clicked before (i.e. the link has been @e
-        visited).
+        and the link has already been clicked before (i.e. the link has been @e visited).

     */
     */

-    void SetVisitedColour(const wxColour& colour);
+    virtual void SetVisitedColour(const wxColour& colour);

 };
 
 };