Article Two: Building a UI Platform in C# - Testing via UI Animation

// (c) 2003-2005 Datron, Inc.  All rights reserved. http://www.blix.net

using System;

namespace freeBlix
{
	public abstract class DragBot
	{
		#region Fields
		private Control _Control;
		private ControlSystem _ControlSystem;
		private DragMouseTrap _DragTrap;
		private Tweak _Tweak;
		#endregion

		#region DragBot(aControl)
		public DragBot(Control aControl)
		{
			_Control = aControl;
		
			_DragTrap = new DragMouseTrap(aControl);
			_DragTrap.DragCycle.Enter += new DragCycleEnterDelegate(EnterHandler);
			_DragTrap.DragCycle.Leave += new DragCycleLeaveDelegate(LeaveHandler);
			_DragTrap.DragCycle.Start += new DragCycleStartDelegate(StartHandler);
			_DragTrap.DragCycle.Drag += new DragCycleDragDelegate(DragHandler);
			_DragTrap.DragCycle.End += new DragCycleEndDelegate(EndHandler);
			_DragTrap.DragCycle.Cancel += new DragCycleCancelDelegate(CancelHandler);
		}
		#endregion		

		#region EnterHandler
		private void EnterHandler()
		{
			Enter();
		}	
		#endregion
		#region LeaveHandler
		private void LeaveHandler()
		{
			Leave();
		}	
		#endregion
		#region StartHandler
		private void StartHandler()
		{
			ControlSystem.DragManifest.Start(this);
		}	
		#endregion
		#region DragHandler
		private void DragHandler(Point aCumulativeDelta)
		{
			if (_Tweak != null)
				_Tweak.Apply(aCumulativeDelta);

			ControlSystem.DragManifest.Drag(this, aCumulativeDelta);				
		}
		#endregion
		#region EndHandler
		private void EndHandler()
		{
			ControlSystem.DragManifest.End(this);
		}
		#endregion
		#region CancelHandler
		private void CancelHandler()
		{
			ControlSystem.DragManifest.Cancel(this);
		}
		#endregion

		#region Enter
		public virtual void Enter()
		{
		}	
		#endregion
		#region Leave
		public virtual void Leave()
		{
		}	
		#endregion

		#region Start
		public virtual void Start()
		{
		}	
		#endregion
		#region Land
		public virtual void Land(DropSite aDropSite)
		{
		}	
		#endregion
		#region Drag
		public virtual void Drag(Point aCumulativeDelta)
		{
		}
		#endregion		
		#region End
		public virtual void End()
		{
		}
		#endregion
		#region Cancel
		public virtual void Cancel()
		{
		}
		#endregion			
		
		#region Tweak
		public Tweak Tweak
		{
			get
			{
				return _Tweak;
			}
			set
			{
				_Tweak = value;
			}
		}
		#endregion
		#region Control
		public Control Control
		{
			get
			{
				return _Control;
			}
		}
		#endregion
		#region ControlSystem
		public ControlSystem ControlSystem
		{
			get
			{
				return _ControlSystem;
			}
			set
			{
				if (_ControlSystem != null)
					_ControlSystem.Mouse.RemoveTrap(_DragTrap);

				_ControlSystem = value;

				if (_ControlSystem != null)
					_ControlSystem.Mouse.AddTrap(_DragTrap);
			}
		}
		#endregion
	}
}