Timer Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

Timer.cs

Implementuje czasomierz, który zgłasza zdarzenie w interwałach zdefiniowanych przez użytkownika. Ten czasomierz jest zoptymalizowany pod kątem użycia w aplikacjach Windows Forms i musi być używany w oknie.

public ref class Timer : System::ComponentModel::Component

public class Timer : System.ComponentModel.Component

type Timer = class
    inherit Component

Public Class Timer
Inherits Component

Dziedziczenie

Object

MarshalByRefObject

Component

Timer

Przykłady

Poniższy przykład implementuje prosty czasomierz interwału, który uruchamia alarm co pięć sekund. Po wystąpieniu alarmu wyświetlany jest licznik liczby uruchomień alarmu i monituje użytkownika o to, MessageBox czy czasomierz powinien nadal działać.

public ref class Class1
{
private:
   static System::Windows::Forms::Timer^ myTimer = gcnew System::Windows::Forms::Timer;
   static int alarmCounter = 1;
   static bool exitFlag = false;

   // This is the method to run when the timer is raised.
   static void TimerEventProcessor( Object^ /*myObject*/, EventArgs^ /*myEventArgs*/ )
   {
      myTimer->Stop();
      
      // Displays a message box asking whether to continue running the timer.
      if ( MessageBox::Show( "Continue running?", String::Format( "Count is: {0}", alarmCounter ), MessageBoxButtons::YesNo ) == DialogResult::Yes )
      {
         
         // Restarts the timer and increments the counter.
         alarmCounter += 1;
         myTimer->Enabled = true;
      }
      else
      {
         
         // Stops the timer.
         exitFlag = true;
      }
   }


public:
   static void Main()
   {
      
      /* Adds the event and the event handler for the method that will 
                process the timer event to the timer. */
      myTimer->Tick += gcnew EventHandler( TimerEventProcessor );
      
      // Sets the timer interval to 5 seconds.
      myTimer->Interval = 5000;
      myTimer->Start();
      
      // Runs the timer, and raises the event.
      while ( !exitFlag )
      {
         
         // Processes all the events in the queue.
         Application::DoEvents();
      }
   }

};

int main()
{
   Class1::Main();
}

public class Class1 {
    static System.Windows.Forms.Timer myTimer = new System.Windows.Forms.Timer();
    static int alarmCounter = 1;
    static bool exitFlag = false;
 
    // This is the method to run when the timer is raised.
    private static void TimerEventProcessor(Object myObject,
                                            EventArgs myEventArgs) {
       myTimer.Stop();
 
       // Displays a message box asking whether to continue running the timer.
       if(MessageBox.Show("Continue running?", "Count is: " + alarmCounter, 
          MessageBoxButtons.YesNo) == DialogResult.Yes) {
          // Restarts the timer and increments the counter.
          alarmCounter +=1;
          myTimer.Enabled = true;
       }
       else {
          // Stops the timer.
          exitFlag = true;
       }
    }
 
    public static int Main() {
       /* Adds the event and the event handler for the method that will 
          process the timer event to the timer. */
       myTimer.Tick += new EventHandler(TimerEventProcessor);
 
       // Sets the timer interval to 5 seconds.
       myTimer.Interval = 5000;
       myTimer.Start();
 
       // Runs the timer, and raises the event.
       while(!exitFlag) {
          // Processes all the events in the queue.
          Application.DoEvents();
       }
    return 0;
    }
 }

Public Class Class1
    Private Shared WithEvents myTimer As New System.Windows.Forms.Timer()
    Private Shared alarmCounter As Integer = 1
    Private Shared exitFlag As Boolean = False    
    
    ' This is the method to run when the timer is raised.
    Private Shared Sub TimerEventProcessor(myObject As Object, _
                                           ByVal myEventArgs As EventArgs) _
                                       Handles myTimer.Tick
        myTimer.Stop()
        
        ' Displays a message box asking whether to continue running the timer.
        If MessageBox.Show("Continue running?", "Count is: " & alarmCounter, _
                            MessageBoxButtons.YesNo) = DialogResult.Yes Then
            ' Restarts the timer and increments the counter.
            alarmCounter += 1
            myTimer.Enabled = True
        Else
            ' Stops the timer.
            exitFlag = True
        End If
    End Sub
    
    Public Shared Sub Main()
        ' Adds the event and the event handler for the method that will
        ' process the timer event to the timer.
        
        ' Sets the timer interval to 5 seconds.
        myTimer.Interval = 5000
        myTimer.Start()
        
        ' Runs the timer, and raises the event.
        While exitFlag = False
            ' Processes all the events in the queue.
            Application.DoEvents()
        End While

    End Sub    

End Class

Uwagi

Element służy Timer do zgłaszania zdarzenia w interwałach zdefiniowanych przez użytkownika. Ten czasomierz systemu Windows jest przeznaczony dla środowiska jednowątkowego, w którym wątki interfejsu użytkownika są używane do przetwarzania. Wymaga to, aby kod użytkownika miał dostępną pompę komunikatów interfejsu użytkownika i zawsze działa z tego samego wątku lub marshaling wywołania na inny wątek.

Gdy używasz tego czasomierza, użyj Tick zdarzenia, aby wykonać operację sondowania lub wyświetlić ekran powitalny przez określony okres czasu. Zawsze, Enabled gdy właściwość jest ustawiona na true wartość i Interval właściwość jest większa niż zero, Tick zdarzenie jest wywoływane w odstępach czasu na Interval podstawie ustawienia właściwości.

Ta klasa udostępnia metody ustawiania interwału oraz uruchamiania i zatrzymywania czasomierza.

Uwaga

Składnik Windows Forms Czasomierz jest jednowątkowy i jest ograniczony do dokładności 55 milisekund. Jeśli potrzebujesz czasomierza wielowątkowego z większą dokładnością, użyj Timer klasy w System.Timers przestrzeni nazw.

Konstruktory

Timer()	Inicjuje nowe wystąpienie klasy Timer.
Timer(IContainer)	Inicjuje Timer nowe wystąpienie klasy wraz z określonym kontenerem.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Enabled	Pobiera lub ustawia, czy czasomierz jest uruchomiony.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
Interval	Pobiera lub ustawia czas w milisekundach, zanim Tick zdarzenie zostanie podniesione względem ostatniego Tick wystąpienia zdarzenia.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
Tag	Pobiera lub ustawia dowolny ciąg reprezentujący jakiś typ stanu użytkownika.

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Usuwa zasoby, inne niż pamięć, używane przez czasomierz.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnTick(EventArgs)	Tick Zgłasza zdarzenie.
Start()	Uruchamia czasomierz.
Stop()	Zatrzymuje czasomierz.
ToString()	Zwraca ciąg reprezentujący Timerelement .

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
Tick	Występuje, gdy określony interwał czasomierza upłynął, a czasomierz jest włączony.