//---------------------------------------------------------------------------
//
// Copyright (C) Microsoft Corporation.  All rights reserved.
//
//---------------------------------------------------------------------------
 
using System;
using System.Windows;
using System.Windows.Input;
 
namespace System.Windows.Input
{
    /// <summary>
    ///     Describes a particular position and bounds of a TouchDevice.
    /// </summary>
    public class TouchPoint : IEquatable<TouchPoint>
    {
        /// <summary>
        ///     Creates an instance of this class and initializes its properties.
        /// </summary>
        /// <param name="device">
        ///     The TouchDevice that this TouchPoint describes. Must be non-null.
        /// </param>
        /// <param name="position">
        ///     The current location of the device.
        ///     The coordinate space of this parameter is defined by the caller and should be
        ///     consistent with the rectBounds parameter.
        /// </param>
        /// <param name="bounds">
        ///     The bounds of the area that the TouchDevice (i.e. finger) is in contact with the screen. 
        ///     The coordinate space of this parameter is defined by the caller and should be
        ///     consistent with the position parameter.</param>
        /// <param name="action">
        ///     Indicates the last action that occured by this device at this location.
        /// </param>
        public TouchPoint(TouchDevice device, Point position, Rect bounds, TouchAction action)
        {
            if (device == null)
            {
                throw new ArgumentNullException("device");
            }
 
            TouchDevice = device;
            Position = position;
            Bounds = bounds;
            Action = action;
        }
 
        /// <summary>
        ///     The device associated with this TouchPoint.
        /// </summary>
        public TouchDevice TouchDevice
        {
            get;
            private set;
        }
 
        /// <summary>
        ///     The position of this device. The coordinate space is defined
        ///     by the provider of this object.
        /// </summary>
        public Point Position
        {
            get;
            private set;
        }
 
        /// <summary>
        ///     The bounds of the area that the finger is in contact with
        ///     the screen. The coordinate space is defined by the
        ///     provider of this object.
        /// </summary>
        public Rect Bounds
        {
            get;
            private set;
        }
 
        /// <summary>
        ///     Equivalent to Bounds.Size.
        /// </summary>
        public Size Size
        {
            get
            {
                return Bounds.Size;
            }
        }
 
        /// <summary>
        ///     The last action associated with this device.
        /// </summary>
        public TouchAction Action
        {
            get;
            private set;
        }
 
        #region IEquatable
 
        /// <summary>
        ///     Whether two TouchPoints are equivalent.
        /// </summary>
        /// <param name="other">Another TouchPoint.</param>
        /// <returns>true if this TouchPoint and the other TouchPoint are equivalent.</returns>
        bool IEquatable<TouchPoint>.Equals(TouchPoint other)
        {
            if (other != null)
            {
                return (other.TouchDevice == TouchDevice) &&
                    (other.Position == Position) &&
                    (other.Bounds == Bounds) &&
                    (other.Action == Action);
            }
 
            return false;
        }
 
        #endregion
    }
}