Update selection cache when inserting items, too

[wxWidgets.git] / interface / timer.h

diff --git a/interface/timer.h b/interface/timer.h
index 9099f0db44775db1e07515a39892abffcf04065c..49de74c8ef1aaffd87a33c9a20baded614ee260a 100644 (file)
--- a/interface/timer.h
+++ b/interface/timer.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        timer.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        timer.h

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

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


@@ -9,47 +9,46 @@
 /**
     @class wxTimer
     @wxheader{timer.h}
 /**
     @class wxTimer
     @wxheader{timer.h}

-    
+

     The wxTimer class allows you to execute code at specified intervals. Its
     precision is platform-dependent, but in general will not be better than 1ms nor
     worse than 1s.
     The wxTimer class allows you to execute code at specified intervals. Its
     precision is platform-dependent, but in general will not be better than 1ms nor
     worse than 1s.

-    
+

     There are three different ways to use this class:
     There are three different ways to use this class:

-    
-     You may derive a new class from wxTimer and override the 
+
+     You may derive a new class from wxTimer and override the

     wxTimer::Notify member to perform the required action.
     wxTimer::Notify member to perform the required action.

-     Or you may redirect the notifications to any 
+     Or you may redirect the notifications to any

     wxEvtHandler derived object by using the non-default
     wxEvtHandler derived object by using the non-default

-    constructor or wxTimer::SetOwner. Then use the @c EVT_TIMER 
-    macro to connect it to the event handler which will receive 
+    constructor or wxTimer::SetOwner. Then use the @c EVT_TIMER
+    macro to connect it to the event handler which will receive

     wxTimerEvent notifications.
     wxTimerEvent notifications.

-     Or you may use a derived class and the @c EVT_TIMER 
+     Or you may use a derived class and the @c EVT_TIMER

     macro to connect it to an event handler defined in the derived class.
     If the default constructor is used, the timer object will be its
     own owner object, since it is derived from wxEvtHandler.
     macro to connect it to an event handler defined in the derived class.
     If the default constructor is used, the timer object will be its
     own owner object, since it is derived from wxEvtHandler.

-    
-    In any case, you must start the timer with wxTimer::Start 
+
+    In any case, you must start the timer with wxTimer::Start

     after constructing it before it actually starts sending notifications. It can
     be stopped later with wxTimer::Stop.
     after constructing it before it actually starts sending notifications. It can
     be stopped later with wxTimer::Stop.

-    
-    @b Note: A timer can only be used from the main thread.
-    
+
+    @note A timer can only be used from the main thread.
+

     @library{wxbase}
     @category{misc}
     @library{wxbase}
     @category{misc}

-    
-    @seealso
-    wxStopWatch
+
+    @see wxStopWatch

 */
 class wxTimer : public wxEvtHandler
 {
 public:
     //@{
     /**
 */
 class wxTimer : public wxEvtHandler
 {
 public:
     //@{
     /**

-        Creates a timer and associates it with @e owner. Please see 
+        Creates a timer and associates it with @e owner. Please see

         SetOwner() for the description of parameters.
     */
     wxTimer();
         SetOwner() for the description of parameters.
     */
     wxTimer();

-        wxTimer(wxEvtHandler * owner, int id = -1);
+    wxTimer(wxEvtHandler* owner, int id = -1);

     //@}
 
     /**
     //@}
 
     /**


@@ -60,71 +59,66 @@ public:
     /**
         Returns the ID of the events generated by this timer.
     */
     /**
         Returns the ID of the events generated by this timer.
     */

-    int GetId();
+    int GetId() const;

 
     /**
         Returns the current interval for the timer (in milliseconds).
     */
 
     /**
         Returns the current interval for the timer (in milliseconds).
     */

-    int GetInterval();
+    int GetInterval() const;

 
     /**
         Returns the current @e owner of the timer.
 
     /**
         Returns the current @e owner of the timer.

-        If non-@NULL this is the event handler which will receive the 
+        If non-@NULL this is the event handler which will receive the

         @ref overview_wxtimerevent "timer events" when the timer is running.
     */
         @ref overview_wxtimerevent "timer events" when the timer is running.
     */

-    wxEvtHandler GetOwner();
+    wxEvtHandler GetOwner() const;

 
     /**
         Returns @true if the timer is one shot, i.e. if it will stop after firing the
         first notification automatically.
     */
 
     /**
         Returns @true if the timer is one shot, i.e. if it will stop after firing the
         first notification automatically.
     */

-    bool IsOneShot();
+    bool IsOneShot() const;

 
     /**
         Returns @true if the timer is running, @false if it is stopped.
     */
 
     /**
         Returns @true if the timer is running, @false if it is stopped.
     */

-    bool IsRunning();
+    bool IsRunning() const;

 
     /**
         This member should be overridden by the user if the default constructor was
         used and SetOwner() wasn't called.
 
     /**
         This member should be overridden by the user if the default constructor was
         used and SetOwner() wasn't called.

-        

         Perform whatever action which is to be taken periodically here.
     */
     void Notify();
 
     /**
         Perform whatever action which is to be taken periodically here.
     */
     void Notify();
 
     /**

-        Associates the timer with the given @e owner object. When the timer is
+        Associates the timer with the given @a owner object. When the timer is

         running, the owner will receive @ref overview_wxtimerevent "timer events" with
         running, the owner will receive @ref overview_wxtimerevent "timer events" with

-        id equal to @e id specified here.
+        id equal to @a id specified here.

     */
     */

-    void SetOwner(wxEvtHandler * owner, int id = -1);
+    void SetOwner(wxEvtHandler* owner, int id = -1);

 
     /**
 
     /**

-        (Re)starts the timer. If @e milliseconds parameter is -1 (value by default),
+        (Re)starts the timer. If @a milliseconds parameter is -1 (value by default),

         the previous value is used. Returns @false if the timer could not be started,
         @true otherwise (in MS Windows timers are a limited resource).
         the previous value is used. Returns @false if the timer could not be started,
         @true otherwise (in MS Windows timers are a limited resource).

-        
-        If @e oneShot is @false (the default), the Notify() 
+        If @a oneShot is @false (the default), the Notify()

         function will be called repeatedly until the timer is stopped. If @true,
         it will be called only once and the timer will stop automatically. To make your
         code more readable you may also use the following symbolic constants:
         function will be called repeatedly until the timer is stopped. If @true,
         it will be called only once and the timer will stop automatically. To make your
         code more readable you may also use the following symbolic constants:

-        
-        
+

         wxTIMER_CONTINUOUS
         wxTIMER_CONTINUOUS

-        
-        
+

         Start a normal, continuously running, timer
         Start a normal, continuously running, timer

-        
+

         wxTIMER_ONE_SHOT
         wxTIMER_ONE_SHOT

-        
-        
+

         Start a one shot timer
         Start a one shot timer

-        
+

         If the timer was already running, it will be stopped by this method before
         restarting it.
     */
         If the timer was already running, it will be stopped by this method before
         restarting it.
     */

-    bool Start(int milliseconds = -1, bool oneShot = @false);
+    bool Start(int milliseconds = -1, bool oneShot = false);

 
     /**
         Stops the timer.
 
     /**
         Stops the timer.


@@ -133,46 +127,46 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxTimerEvent
     @wxheader{timer.h}
 /**
     @class wxTimerEvent
     @wxheader{timer.h}

-    
+

     wxTimerEvent object is passed to the event handler of timer events.
     wxTimerEvent object is passed to the event handler of timer events.

-    
+

     For example:
     For example:

-    
+

     @code
     class MyFrame : public wxFrame
     {
     public:
         ...
         void OnTimer(wxTimerEvent& event);
     @code
     class MyFrame : public wxFrame
     {
     public:
         ...
         void OnTimer(wxTimerEvent& event);

-    
+

     private:
         wxTimer m_timer;
     };
     private:
         wxTimer m_timer;
     };

-    
+

     BEGIN_EVENT_TABLE(MyFrame, wxFrame)
         EVT_TIMER(TIMER_ID, MyFrame::OnTimer)
     END_EVENT_TABLE()
     BEGIN_EVENT_TABLE(MyFrame, wxFrame)
         EVT_TIMER(TIMER_ID, MyFrame::OnTimer)
     END_EVENT_TABLE()

-    
+

     MyFrame::MyFrame()
            : m_timer(this, TIMER_ID)
     {
         m_timer.Start(1000);    // 1 second interval
     }
     MyFrame::MyFrame()
            : m_timer(this, TIMER_ID)
     {
         m_timer.Start(1000);    // 1 second interval
     }

-    
+

     void MyFrame::OnTimer(wxTimerEvent& event)
     {
         // do whatever you want to do every second here
     }
     @endcode
     void MyFrame::OnTimer(wxTimerEvent& event)
     {
         // do whatever you want to do every second here
     }
     @endcode

-    
+

     @library{wxbase}
     @category{events}
     @library{wxbase}
     @category{events}

-    
-    @seealso
-    wxTimer
+
+    @see wxTimer

 */
 class wxTimerEvent : public wxEvent
 {
 */
 class wxTimerEvent : public wxEvent
 {


@@ -180,10 +174,11 @@ public:
     /**
         Returns the interval of the timer which generated this event.
     */
     /**
         Returns the interval of the timer which generated this event.
     */

-    int GetInterval();
+    int GetInterval() const;

 
     /**
         Returns the timer object which generated this event.
     */
 
     /**
         Returns the timer object which generated this event.
     */

-    wxTimer GetTimer();
+    wxTimer GetTimer() const;

 };
 };

+