]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/hyperlink.h
Add test for absence of events from wxSpinCtrlDouble ctor.
[wxWidgets.git] / interface / wx / hyperlink.h
index 0b1685eb8d03def487916ec80f87bf1827117503..de28dd31a5f9860e3afa22f13b8bd5e57ffe9ae3 100644 (file)
@@ -2,18 +2,27 @@
 // Name:        hyperlink.h
 // Purpose:     interface of wxHyperlinkEvent
 // Author:      wxWidgets team
 // Name:        hyperlink.h
 // Purpose:     interface of wxHyperlinkEvent
 // Author:      wxWidgets team
-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /////////////////////////////////////////////////////////////////////////////
 
+#define wxHL_CONTEXTMENU        0x0001
+#define wxHL_ALIGN_LEFT         0x0002
+#define wxHL_ALIGN_RIGHT        0x0004
+#define wxHL_ALIGN_CENTRE       0x0008
+#define wxHL_DEFAULT_STYLE      (wxHL_CONTEXTMENU|wxNO_BORDER|wxHL_ALIGN_CENTRE)
+
 /**
     @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 +30,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.
@@ -36,28 +44,32 @@ public:
 };
 
 
 };
 
 
+wxEventType wxEVT_HYPERLINK;
 
 /**
     @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}
            Align the text to the left.
     @style{wxHL_ALIGN_RIGHT}
 
     @beginStyleTable
     @style{wxHL_ALIGN_LEFT}
            Align the text to the left.
     @style{wxHL_ALIGN_RIGHT}
-           Align the text to the right.
+           Align the text to the right. This style is not supported under
+           Windows XP but is supported under all the other Windows versions.
     @style{wxHL_ALIGN_CENTRE}
     @style{wxHL_ALIGN_CENTRE}
-           Center the text (horizontally).
+           Center the text (horizontally). This style is not supported by the
+           native MSW implementation used under Windows XP and later.
     @style{wxHL_CONTEXTMENU}
            Pop up a context menu when the hyperlink is right-clicked. The
            context menu contains a "Copy URL" menu item which is automatically
     @style{wxHL_CONTEXTMENU}
            Pop up a context menu when the hyperlink is right-clicked. The
            context menu contains a "Copy URL" menu item which is automatically
@@ -68,25 +80,38 @@ public:
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable
 
            wxBORDER_NONE|wxHL_CONTEXTMENU|wxHL_ALIGN_CENTRE.
     @endStyleTable
 
+    @beginEventEmissionTable{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
+
+    Currently this class is implemented using native support in wxGTK and wxMSW
+    (under Windows XP and later only) and a generic version is used by the
+    other ports.
+
     @library{wxadv}
     @category{ctrl}
     @library{wxadv}
     @category{ctrl}
-    @appearance{hyperlinkctrl.png}
+    @appearance{hyperlinkctrl}
 
     @see wxURL, wxHyperlinkEvent
 */
 class wxHyperlinkCtrl : public wxControl
 {
 public:
 
     @see wxURL, wxHyperlinkEvent
 */
 class wxHyperlinkCtrl : public wxControl
 {
 public:
+    wxHyperlinkCtrl();
+    
     /**
         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 = wxHL_DEFAULT_STYLE,
-                const wxString& name = "hyperlink");
+    wxHyperlinkCtrl(wxWindow* parent, wxWindowID id,
+                    const wxString& label,
+                    const wxString& url,
+                    const wxPoint& pos = wxDefaultPosition,
+                    const wxSize& size = wxDefaultSize,
+                    long style = wxHL_DEFAULT_STYLE,
+                    const wxString& name = wxHyperlinkCtrlNameStr);
 
     /**
         Creates the hyperlink control.
 
     /**
         Creates the hyperlink control.
@@ -102,12 +127,10 @@ 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.
     */
@@ -125,8 +148,7 @@ public:
 
     /**
         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.
     */
     virtual wxColour GetNormalColour() const;
 
     */
     virtual wxColour GetNormalColour() const;
 
@@ -143,9 +165,8 @@ 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).
     */
     virtual wxColour GetVisitedColour() const;
 
     */
     virtual wxColour GetVisitedColour() const;
 
@@ -156,8 +177,7 @@ public:
     virtual 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.
     */
     virtual void SetNormalColour(const wxColour& colour);
         (i.e. the link has not been @e visited) and the mouse is not over the control.
     */
     virtual void SetNormalColour(const wxColour& colour);
@@ -174,8 +194,7 @@ 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).
     */
     virtual void SetVisitedColour(const wxColour& colour);
 };
     */
     virtual void SetVisitedColour(const wxColour& colour);
 };