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;
41 internal IntPtr window;
46 internal static readonly int Minimum = 15;
53 public Timer (IContainer container) : this ()
58 [DefaultValue (false)]
59 public virtual bool Enabled {
64 if (value != enabled) {
67 // Use AddTicks so we get some rounding
68 expires = DateTime.UtcNow.AddMilliseconds (interval > Minimum ? interval : Minimum);
70 thread = Thread.CurrentThread;
71 XplatUI.SetTimer (this);
73 XplatUI.KillTimer (this);
88 throw new ArgumentOutOfRangeException ("Interval", string.Format ("'{0}' is not a valid value for Interval. Interval must be greater than 0.", value));
90 throw new ArgumentException (string.Format("'{0}' is not a valid value for Interval. Interval must be greater than 0.", value));
93 if (interval == value) {
99 // Use AddTicks so we get some rounding
100 expires = DateTime.UtcNow.AddMilliseconds (interval > Minimum ? interval : Minimum);
102 if (enabled == true) {
103 XplatUI.KillTimer (this);
104 XplatUI.SetTimer (this);
112 [TypeConverter(typeof(StringConverter))]
114 [MWFCategory("Data")]
136 internal DateTime Expires {
142 public event EventHandler Tick;
144 public override string ToString ()
146 return base.ToString () + ", Interval: " + Interval;
149 internal void Update (DateTime update)
151 expires = update.AddMilliseconds (interval > Minimum ? interval : Minimum);
154 internal void FireTick ()
156 OnTick (EventArgs.Empty);
160 protected virtual void OnTick (EventArgs e)
166 protected override void Dispose (bool disposing)
168 base.Dispose (disposing);
172 internal void TickHandler (object sender, EventArgs e)