]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/dialup.h
Move code removing "-psn_xxx" command line arguments to common code.
[wxWidgets.git] / interface / wx / dialup.h
index 849d21cbbd3b1fd42a68a01b6ace188ea56534d7..5ad0ce53251381e98396175ac101d34766d26eb0 100644 (file)
@@ -2,13 +2,11 @@
 // Name:        dialup.h
 // Purpose:     interface of wxDialUpManager
 // Author:      wxWidgets team
 // Name:        dialup.h
 // Purpose:     interface of wxDialUpManager
 // Author:      wxWidgets team
-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxDialUpManager
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @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
 
     This class encapsulates functions dealing with verifying the connection
     status of the workstation (connected to the Internet via a direct
     most one instance of this class in the program accessed via Create() and
     you can't create the objects of this class directly.
 
     most one instance of this class in the program accessed via Create() and
     you can't create the objects of this class directly.
 
-    @beginEventTable{wxDialUpEvent}
+    @beginEventEmissionTable{wxDialUpEvent}
     @event{EVT_DIALUP_CONNECTED(func)}
     @event{EVT_DIALUP_CONNECTED(func)}
-           A connection with the network was established.
+        A connection with the network was established.
     @event{EVT_DIALUP_DISCONNECTED(func)}
     @event{EVT_DIALUP_DISCONNECTED(func)}
-           The connection with the network was lost.
+        The connection with the network was lost.
     @endEventTable
 
     @library{wxcore}
     @endEventTable
 
     @library{wxcore}
@@ -44,7 +42,7 @@ public:
     /**
         Destructor.
     */
     /**
         Destructor.
     */
-    ~wxDialUpManager();
+    virtual ~wxDialUpManager();
 
     /**
         Cancel dialing the number initiated with Dial() with async parameter
 
     /**
         Cancel dialing the number initiated with Dial() with async parameter
@@ -54,14 +52,14 @@ public:
 
         @see IsDialing()
     */
 
         @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.
     */
 
     /**
         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.
 
     /**
         Dial the given ISP, use @a username and @a password to authenticate.
@@ -81,20 +79,20 @@ public:
         returns immediately - the result is reported via events (an event is
         sent anyhow, but if dialing failed it will be a DISCONNECTED one).
     */
         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.
     */
 
     /**
         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
 
     /**
         Enable automatic checks for the connection status and sending of
-        wxEVT_DIALUP_CONNECTED/wxEVT_DIALUP_DISCONNECTED events. The interval
+        @c wxEVT_DIALUP_CONNECTED/wxEVT_DIALUP_DISCONNECTED events. The interval
         parameter is only for Unix where we do the check manually and specifies
         how often should we repeat the check (each minute by default). Under
         Windows, the notification about the change of connection status is sent
         parameter is only for Unix where we do the check manually and specifies
         how often should we repeat the check (each minute by default). Under
         Windows, the notification about the change of connection status is sent
@@ -103,7 +101,7 @@ public:
 
         @return @false if couldn't set up automatic check for online status.
     */
 
         @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.
 
     /**
         This function is only implemented under Windows.
@@ -112,15 +110,15 @@ public:
         parameter to Dial() on this machine and returns their number (may be
         0).
     */
         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.
     */
 
     /**
         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.
+        Returns @true if the computer has a permanent network connection (i.e.\
         is on a LAN) and so there is no need to use Dial() function to go
         online.
 
         is on a LAN) and so there is no need to use Dial() function to go
         online.
 
@@ -128,14 +126,14 @@ public:
               guaranteed to be correct, so it is better to ask user for
               confirmation or give him a possibility to override it.
     */
               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()
     */
 
     /**
         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
 
     /**
         Returns @true if the dialup manager was initialized correctly. If this
@@ -143,7 +141,7 @@ public:
         a good idea to call this function and check its result before calling
         any other wxDialUpManager methods.
     */
         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
 
     /**
         Returns @true if the computer is connected to the network: under
@@ -151,15 +149,15 @@ public:
         check that the "well-known host" (as specified by SetWellKnownHost())
         is reachable.
     */
         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.
     */
 
     /**
         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
 
     /**
         Sometimes the built-in logic for determining the online status may
@@ -169,7 +167,7 @@ public:
 
         @see IsOnline()
     */
 
         @see IsOnline()
     */
-    void SetOnlineStatus(bool isOnline = true);
+    virtual void SetOnlineStatus(bool isOnline = true) = 0;
 
     /**
         This method is for Unix only.
 
     /**
         This method is for Unix only.
@@ -179,14 +177,14 @@ public:
         function is always safe to call. The default value is
         @c "www.yahoo.com:80".
     */
         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
 };
 
 
 
 /**
     @class wxDialUpEvent
-    @wxheader{dialup.h}
 
     This is the event class for the dialup events sent by wxDialUpManager.
 
 
     This is the event class for the dialup events sent by wxDialUpManager.
 
@@ -208,7 +206,7 @@ public:
     bool IsConnectedEvent() const;
 
     /**
     bool IsConnectedEvent() const;
 
     /**
-        Does this event come from wxDialUpManager::Dial() or from some extrenal
+        Does this event come from wxDialUpManager::Dial() or from some external
         process (i.e. does it result from our own attempt to establish the
         connection)?
     */
         process (i.e. does it result from our own attempt to establish the
         connection)?
     */