clarify role of wxToolBarToolBase (fixes #9874)

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

diff --git a/interface/wx/dialup.h b/interface/wx/dialup.h
index 849d21cbbd3b1fd42a68a01b6ace188ea56534d7..bbc06f5c88ec78d6c08de5d268a186b0a29260e0 100644 (file)
--- a/interface/wx/dialup.h
+++ b/interface/wx/dialup.h
@@ -8,7 +8,6 @@
 
 /**
     @class wxDialUpManager
-    @wxheader{dialup.h}
 
     This class encapsulates functions dealing with verifying the connection
     status of the workstation (connected to the Internet via a direct
@@ -44,7 +43,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDialUpManager();
+    virtual ~wxDialUpManager();
 
     /**
         Cancel dialing the number initiated with Dial() with async parameter
@@ -54,14 +53,14 @@ public:
 
         @see IsDialing()
     */
-    bool CancelDialing();
+    virtual bool CancelDialing() = 0;
 
     /**
         This function should create and return the object of the
         platform-specific class derived from wxDialUpManager. You should delete
         the pointer when you are done with it.
     */
-    wxDialUpManager* Create();
+    static wxDialUpManager* Create();
 
     /**
         Dial the given ISP, use @a username and @a password to authenticate.
@@ -81,16 +80,16 @@ public:
         returns immediately - the result is reported via events (an event is
         sent anyhow, but if dialing failed it will be a DISCONNECTED one).
     */
-    bool Dial(const wxString& nameOfISP = wxEmptyString,
-              const wxString& username = wxEmptyString,
-              const wxString& password = wxEmptyString,
-              bool async = true);
+    virtual bool Dial(const wxString& nameOfISP = wxEmptyString,
+                      const wxString& username = wxEmptyString,
+                      const wxString& password = wxEmptyString,
+                      bool async = true) = 0;
 
     /**
         Disable automatic check for connection status change - notice that the
         @c wxEVT_DIALUP_XXX events won't be sent any more neither.
     */
-    void DisableAutoCheckOnlineStatus();
+    virtual void DisableAutoCheckOnlineStatus() = 0;
 
     /**
         Enable automatic checks for the connection status and sending of
@@ -103,7 +102,7 @@ public:
 
         @return @false if couldn't set up automatic check for online status.
     */
-    bool EnableAutoCheckOnlineStatus(size_t nSeconds = 60);
+    virtual bool EnableAutoCheckOnlineStatus(size_t nSeconds = 60) = 0;
 
     /**
         This function is only implemented under Windows.
@@ -112,12 +111,12 @@ public:
         parameter to Dial() on this machine and returns their number (may be
         0).
     */
-    size_t GetISPNames(wxArrayString& names) const;
+    virtual size_t GetISPNames(wxArrayString& names) const = 0;
 
     /**
         Hang up the currently active dial up connection.
     */
-    bool HangUp();
+    virtual bool HangUp() = 0;
 
     /**
         Returns @true if the computer has a permanent network connection (i.e.
@@ -128,14 +127,14 @@ public:
               guaranteed to be correct, so it is better to ask user for
               confirmation or give him a possibility to override it.
     */
-    bool IsAlwaysOnline() const;
+    virtual bool IsAlwaysOnline() const = 0;
 
     /**
         Returns @true if (async) dialing is in progress.
 
         @see Dial()
     */
-    bool IsDialing() const;
+    virtual bool IsDialing() const = 0;
 
     /**
         Returns @true if the dialup manager was initialized correctly. If this
@@ -143,7 +142,7 @@ public:
         a good idea to call this function and check its result before calling
         any other wxDialUpManager methods.
     */
-    bool IsOk() const;
+    virtual bool IsOk() const = 0;
 
     /**
         Returns @true if the computer is connected to the network: under
@@ -151,15 +150,15 @@ public:
         check that the "well-known host" (as specified by SetWellKnownHost())
         is reachable.
     */
-    bool IsOnline() const;
+    virtual bool IsOnline() const = 0;
 
     /**
         This method is for Unix only.
 
         Sets the commands to start up the network and to hang up again.
     */
-    void SetConnectCommand(const wxString& commandDial = "/usr/bin/pon",
-                           const wxString& commandHangup = "/usr/bin/poff") const;
+    virtual void SetConnectCommand(const wxString& commandDial = "/usr/bin/pon",
+                                   const wxString& commandHangup = "/usr/bin/poff") = 0;
 
     /**
         Sometimes the built-in logic for determining the online status may
@@ -169,7 +168,7 @@ public:
 
         @see IsOnline()
     */
-    void SetOnlineStatus(bool isOnline = true);
+    virtual void SetOnlineStatus(bool isOnline = true) = 0;
 
     /**
         This method is for Unix only.
@@ -179,14 +178,14 @@ public:
         function is always safe to call. The default value is
         @c "www.yahoo.com:80".
     */
-    void SetWellKnownHost(const wxString& hostname, int portno = 80);
+    virtual void SetWellKnownHost(const wxString& hostname,
+                                  int portno = 80) = 0;
 };
 
 
 
 /**
     @class wxDialUpEvent
-    @wxheader{dialup.h}
 
     This is the event class for the dialup events sent by wxDialUpManager.