1 // Permission is hereby granted, free of charge, to any person obtaining
2 // a copy of this software and associated documentation files (the
3 // "Software"), to deal in the Software without restriction, including
4 // without limitation the rights to use, copy, modify, merge, publish,
5 // distribute, sublicense, and/or sell copies of the Software, and to
6 // permit persons to whom the Software is furnished to do so, subject to
7 // the following conditions:
9 // The above copyright notice and this permission notice shall be
10 // included in all copies or substantial portions of the Software.
12 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
13 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
15 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
16 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
17 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
18 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
20 // Copyright (c) 2004 Novell, Inc.
23 // Jackson Harper (jackson@ximian.com)
27 using System
.Threading
;
28 using System
.ComponentModel
;
30 namespace System
.Windows
.Forms
{
31 [DefaultProperty("Interval")]
32 [DefaultEvent("Tick")]
33 [ToolboxItemFilter("System.Windows.Forms", ToolboxItemFilterType
.Allow
)]
34 public class Timer
: Component
{
37 private int interval
= 100;
38 private DateTime expires
;
39 internal Thread thread
;
44 internal static readonly int Minimum
= 15;
51 public Timer (IContainer container
) : this ()
56 [DefaultValue (false)]
57 public virtual bool Enabled
{
62 if (value != enabled
) {
65 // Use AddTicks so we get some rounding
66 expires
= DateTime
.UtcNow
.AddMilliseconds (interval
> Minimum
? interval
: Minimum
);
68 thread
= Thread
.CurrentThread
;
69 XplatUI
.SetTimer (this);
71 XplatUI
.KillTimer (this);
85 throw new ArgumentException (string.Format("'{0}' is not a valid value for Interval. Interval must be greater than 0.", value));
87 if (interval
== value) {
93 // Use AddTicks so we get some rounding
94 expires
= DateTime
.UtcNow
.AddMilliseconds (interval
> Minimum
? interval
: Minimum
);
96 if (enabled
== true) {
97 XplatUI
.KillTimer (this);
98 XplatUI
.SetTimer (this);
106 [TypeConverter(typeof(StringConverter
))]
108 [MWFCategory("Data")]
130 internal DateTime Expires
{
136 public event EventHandler Tick
;
138 public override string ToString ()
140 return base.ToString () + ", Interval: " + Interval
;
143 internal void Update (DateTime update
)
145 expires
= update
.AddMilliseconds (interval
> Minimum
? interval
: Minimum
);
148 internal void FireTick ()
150 OnTick (EventArgs
.Empty
);
154 protected virtual void OnTick (EventArgs e
)
160 protected override void Dispose (bool disposing
)
162 base.Dispose (disposing
);
166 internal void TickHandler (object sender
, EventArgs e
)