Don't accept picker text events from any old text control

[wxWidgets.git] / interface / hyperlink.h

diff --git a/interface/hyperlink.h b/interface/hyperlink.h
index 7506b08643a0d261741a96a8b03bc56bf9afbd5e..665a8ec43ef53bb9b0575c4d5b6bca4ec68eebfc 100644 (file)
--- a/interface/hyperlink.h
+++ b/interface/hyperlink.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        hyperlink.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        hyperlink.h

-// Purpose:     documentation for wxHyperlinkEvent class
+// Purpose:     interface of wxHyperlinkEvent

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -9,10 +9,10 @@
 /**
     @class wxHyperlinkEvent
     @wxheader{hyperlink.h}
 /**
     @class wxHyperlinkEvent
     @wxheader{hyperlink.h}

-    
+

     This event class is used for the events generated by
     wxHyperlinkCtrl.
     This event class is used for the events generated by
     wxHyperlinkCtrl.

-    
+

     @library{wxadv}
     @category{FIXME}
 */
     @library{wxadv}
     @category{FIXME}
 */


@@ -22,36 +22,37 @@ 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.
     */

-#define wxString GetURL()     /* implementation is private */
+    wxString GetURL() const;

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

-#define void SetURL(const wxString & url)     /* implementation is private */
+    void SetURL(const wxString& url);

 };
 
 
 };
 
 

+

 /**
     @class wxHyperlinkCtrl
     @wxheader{hyperlink.h}
 /**
     @class wxHyperlinkCtrl
     @wxheader{hyperlink.h}

-    
+

     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
     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
+    wxLaunchDefaultBrowser() is done with the

     hyperlink's URL.
     hyperlink's URL.

-    
+

     Note that standard wxWindow functions like wxWindow::SetBackgroundColour,
     wxWindow::SetFont, wxWindow::SetCursor, wxWindow::SetLabel can be used to customize appearance of the hyperlink.
     Note that standard wxWindow functions like wxWindow::SetBackgroundColour,
     wxWindow::SetFont, wxWindow::SetCursor, wxWindow::SetLabel can be used to customize appearance of the hyperlink.

-    
+

     @beginStyleTable
     @style{wxHL_ALIGN_LEFT}:
            Align the text to the left.
     @beginStyleTable
     @style{wxHL_ALIGN_LEFT}:
            Align the text to the left.


@@ -68,13 +69,12 @@ public:
            The default style for wxHyperlinkCtrl:
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable
            The default style for wxHyperlinkCtrl:
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable

-    
+

     @library{wxadv}
     @category{ctrl}
     @appearance{hyperlinkctrl.png}
     @library{wxadv}
     @category{ctrl}
     @appearance{hyperlinkctrl.png}

-    
-    @seealso
-    wxURL, wxHyperlinkEvent
+
+    @see wxURL, wxHyperlinkEvent

 */
 class wxHyperlinkCtrl : public wxControl
 {
 */
 class wxHyperlinkCtrl : public wxControl
 {


@@ -82,37 +82,29 @@ public:
     /**
         Creates the hyperlink control.
         
     /**
         Creates the hyperlink control.
         

-        @param parent 
-        Parent window. Must not be @NULL.
-        
-        @param id 
-        Window identifier. A value of wxID_ANY indicates a default value.
-        
-        @param label 
-        The label of the hyperlink.
-        
-        @param url 
-        The URL associated with the given label.
-        
-        @param pos 
-        Window position.
-        
-        @param size 
-        Window size. If the wxDefaultSize is specified then the window is sized
-        appropriately.
-        
-        @param style 
-        Window style. See wxHyperlinkCtrl.
-        
-        @param validator 
-        Window validator.
-        
-        @param name 
-        Window name.
+        @param parent
+            Parent window. Must not be @NULL.
+        @param id
+            Window identifier. A value of wxID_ANY indicates a default value.
+        @param label
+            The label of the hyperlink.
+        @param url
+            The URL associated with the given label.
+        @param pos
+            Window position.
+        @param size
+            Window size. If the wxDefaultSize is specified then the window is sized
+            appropriately.
+        @param style
+            Window style. See wxHyperlinkCtrl.
+        @param validator
+            Window validator.
+        @param name
+            Window name.

     */
     bool Create(wxWindow* parent, wxWindowID id,
     */
     bool Create(wxWindow* parent, wxWindowID id,

-                const wxString & label,
-                const wxString & url,
+                const wxString& label,
+                const wxString& url,

                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
                 long style,


@@ -122,25 +114,25 @@ public:
         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();
+    wxColour GetHoverColour() const;

 
     /**
         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.
     */
 
     /**
         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.
     */

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

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

-#define wxString GetURL()     /* implementation is private */
+    wxString GetURL() const;

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

-    bool GetVisited();
+    bool GetVisited() const;

 
     /**
         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


@@ -148,46 +140,47 @@ public:
         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).
     */

-    wxColour GetVisitedColour();
+    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);
+    void SetHoverColour(const wxColour& colour);

 
     /**
         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.
     */
 
     /**
         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.
     */

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

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

-#define void SetURL(const wxString & url)     /* implementation is private */
+    void SetURL(const wxString& url);

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

-    void SetVisited(bool visited = @true);
+    void SetVisited(bool visited = true);

 
     /**
         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).
     */
 
     /**
         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).
     */

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

 
     /**
         Constructor. See Create() for more info.
     */
 
     /**
         Constructor. See Create() for more info.
     */

-     wxHyperLink(wxWindow* parent, wxWindowID id,
-                 const wxString & label,
-                 const wxString & url,
-                 const wxPoint& pos = wxDefaultPosition,
-                 const wxSize& size = wxDefaultSize,
-                 long style,
-                 const wxString& name = "hyperlink");
+    wxHyperLink(wxWindow* parent, wxWindowID id,
+                const wxString& label,
+                const wxString& url,
+                const wxPoint& pos = wxDefaultPosition,
+                const wxSize& size = wxDefaultSize,
+                long style,
+                const wxString& name = "hyperlink");

 };
 };

+