欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

WP7学习笔记—Silverlight多点触摸事件详解【含Demo代码】

程序员文章站 2022-03-23 11:45:07
最近在学习WP7的Silverlight编程,就把学习到知识点整理为日志,方便自己理解深刻点,也作为笔记和备忘,如有不合理或者错误之处,还恳请指正。  &nbs...

最近在学习WP7的Silverlight编程,就把学习到知识点整理为日志,方便自己理解深刻点,也作为笔记和备忘,如有不合理或者错误之处,还恳请指正。
    WP7的支持多点触摸,有两种不同的编程模式: 1、低级别使用Touch.FrameReported事件 2、高级别的使用UIElement类中定义三个事件:ManipulationStarted,ManipulationDelta和ManipulationCompleted。下面就对不同的事件进行说明和写Demo。

 
1.低级别触摸事件:Touch.FrameReported
       多点触控事件不与其他 Silverlight 输入事件(如 MouseLeftButtonDown)使用相同的事件模型。多点触控输入事件是在应用程序级别处理的单一事件,而不是公开为可能通过 UI 的对象树路由的特定于元素的事件。然后通过事件,使用 TouchFrameEventArgs 并调用 GetPrimaryTouchPoint 和特定 UI 元素及其边界。这将确定应用程序 UI 布局中的特定触控点参考框架。
 
 Touch类:提供应用程序级服务,用以处理来自操作系统的多点触控输入并引发FrameReported事件。
  使用Touch.FrameReported事件处理程序:
Touch.FrameReported += OnTouchFrameReported;
  OnTouchFrameReported 方法格式如下:
  void OnTouchFrameReported(object sender, TouchFrameEventArgs args)
  {
    //…
  }
    FrameReported事件:当输入系统为 Silverlight 提升 Windows 7 多点触控消息时发生,可以通过对事件进行处理并调用TouchFrameEventArgs事件数据中的GetTouchPoints或其他 API 查看详情。
    TouchFrameEventArgs为 FrameReported 事件提供数据。其主要有三个方法:
   • GetTouchPoints(refElement) :返回一个TouchPointCollection 获取多个接触点的集合,当传递null的时候,GetTouchPoints得到Position属性相对于应用程序的左上角。
   • GetPrimaryTouchPoint(refElement):返回一个TouchPoint 获取第一个手指接触点。
   • SuspendMousePromotionUntilTouchUp(): 禁止该时间被提升为鼠标事件。这个方法来自桌面的Silverlight,很多桌面程序只有鼠标按键,现在有触摸屏了,点一下触摸屏,一小下,就不好区分,这个事件是鼠标点的还是触控事件呢?这个函数就是在处理触控的时候防止同时触发鼠标的点击事件.因此,这个函数只能在,只有在处理第一个触摸事件,并且是在处理按下事件的时候才能调用.否则会抛出异常. 详细解析点击这里查看CSDN一位同学解析。
 
 TouchPoint类:一个TouchPoint的实例代表一个特定的手指触摸屏幕。可通过TouchFrameEventArgs的GetTouchPoints(refElement)或GetPrimaryTouchPoint(refElement)获得。
  TouchPoint的四个属性:
  • Action:动作类型,枚举TouchAction有Down, Move和Up三个值表示手指的按下、移动和离开。
  • Position:位置类型,Point的位置,以左上角为参考点。
  • Size:大小类型,支持接触面积(手指的压力大小),但Windows 7不会返回电话有用的值。
  • TouchDevice: 接触设备的类型TouchDevice。TouchDevice对象有两个得到只读属性:
    1. ID: int类型,用来区分手指,一个特定的手指有一个唯一测ID来触发所有的上下移动的事件。
    2. DirectlyOver: UIElement的类型,你手指的最顶层元素。
 
实例代码:
在xaml页加入一个TextBlock标签,显示TouchPoint属性:
<TextBlock Name="tbTouchPoint" Text=""  />
在后台cs构造函数加入以下代码:
        public MainPage()
        {
            InitializeComponent();
           
           //FrameReported事件
            Touch.FrameReported += OnTouchFrameReported;
        }

        void OnTouchFrameReported(object sender, TouchFrameEventArgs args)
        {
           //取得第一个接触点
            TouchPoint primaryTouchPoint = args.GetPrimaryTouchPoint(null);

            tbTouchPoint.Text = string.Format(@"
    Action: {0}; 
    Position: X={1}, Y={2}; 
    Size: Width={3}, Height={4}; 
    TouchDevice: Id={5};    ",
                primaryTouchPoint.Action,
                primaryTouchPoint.Position.X,
                primaryTouchPoint.Position.Y,
                primaryTouchPoint.Size.Width,
                primaryTouchPoint.Size.Height,
                primaryTouchPoint.TouchDevice.Id);


           //SuspendMousePromotionUntilTouchUp()的用法
            if (primaryTouchPoint != null && primaryTouchPoint.Action == TouchAction.Down)
            {
                args.SuspendMousePromotionUntilTouchUp();
            }

        }
模拟器效果图如下:
 

 WP7学习笔记—Silverlight多点触摸事件详解【含Demo代码】
 

2.高级别的使用UIElement类中定义三个事件:ManipulationStarted,ManipulationDelta和ManipulationCompleted
 
     这3个事件并不是单独来处理每个手指的触控信息的,它们将所有手指的平移和缩放操作进行了整合。由于这3个事件都是在UIElement类中定义的,都是基于具体的元素的,而非应用程序级别的事件,由于任何UI控件都继承于UIElement(如:TextBlock控件集成于FrameworkElement类,而FrameworkElement又继承于UIElement,如下代码),因此我们可以为任何UI元素添加对这些事件的处理,比如ListBox,Canvas,Rectangle等等。
  TextBlok继承
    // Summary:
    //     Provides a lightweight control for displaying small amounts of text..
    [ContentProperty("Inlines", true)]
    public sealed class TextBlock : FrameworkElement
    {
         //省略...
    }

 


    // Summary:
    //     Provides a framework of common APIs for objects that participate in Silverlight
    //     layout. System.Windows.FrameworkElement also defines APIs related to data
    //     binding, object tree, and object lifetime feature areas in Silverlight.
    public abstract class FrameworkElement : UIElement
    {
         //省略...
    }

•   ManipulationStarted事件:当手指按下触摸屏时发生,可以通过事件并调用ManipulationStartedEventArgs的相关方法进行处理。
            ManipulationStartedEventArgs为 ManipulationStarted事件提供数据,其属性和方法如下:
  ManipulationStartedEventArgs的属性和方法
    public sealed class ManipulationStartedEventArgs : RoutedEventArgs
    {
        // Summary:
        //     Initializes a new instance of the System.Windows.Input.ManipulationStartedEventArgs
        //     class.
        public ManipulationStartedEventArgs();

        // Summary:
        //     Gets or sets a value that marks the routed event as handled. Setting to true
        //     prevents most handlers along the event route from handling the same event
        //     again.
        //
        // Returns:
        //     true to mark the routed event handled; false to leave the routed event unhandled,
        //     which permits the event to potentially route further. The default is false.
        public bool Handled { get; set; }
        //
        // Summary:
        //     Gets the container that defines the coordinates for the manipulation.
        //
        // Returns:
        //     The container element.
        public UIElement ManipulationContainer { get; set; }
        //
        // Summary:
        //     Gets the point from which the manipulation originated.
        //
        // Returns:
        //     The point from which the manipulation originated.
        public Point ManipulationOrigin { get; }

        // Summary:
        //     Completes the manipulation without inertia.
        public void Complete();
    }
            Handled属性:bool类型,默认为false。获取或设置一个值,标记为已处理的路由事件(后面做详细说明)。如果设置为true处理相同的事件,防止事件沿线大部分处理程序一次。
            ManipulationContainer属性:UIElement类型,获取操作位置所相对的元素。
            ManipulationOrigin属性:Point类型,获取操作的原点。
            Complete()方法:表示事件完成,直接触发ManipulationCompleted()事件,不会触发ManipulationDelta()事件,一般使用其来取消该操作。

 
•  Manipulationdelta事件:当手指在触摸屏移动时发生,可以通过事件并调用ManipulationDeltaEventArgs的相关方法进行处理。
           ManipulationDeltaEventArgs为 Manipulationdelta事件提供数据,其属性和方法如下:
  ManipulationDeltaEventArgs 属性和方法
    // Summary:
    //     Provides data for the System.Windows.UIElement.ManipulationDelta event.
    public sealed class ManipulationDeltaEventArgs : RoutedEventArgs
    {
        // Summary:
        //     Initializes a new instance of the System.Windows.Input.ManipulationDeltaEventArgs
        //     class.
        public ManipulationDeltaEventArgs();

        // Summary:
        //     Gets the accumulated changes of the current manipulation, as a System.Windows.Input.ManipulationDelta.
        //
        // Returns:
        //     The accumulated changes of the current manipulation.
        public ManipulationDelta CumulativeManipulation { get; }
        //
        // Summary:
        //     Gets the most recent changes of the current manipulation, as a System.Windows.Input.ManipulationDelta.
        //
        // Returns:
        //     The most recent changes of the current manipulation.
        public ManipulationDelta DeltaManipulation { get; }
        //
        // Summary:
        //     Gets or sets a value that marks the routed event as handled. Setting to true
        //     prevents most handlers along the event route from handling the same event
        //     again.
        //
        // Returns:
        //     true to mark the routed event handled; false to leave the routed event unhandled,
        //     which permits the event to potentially route further. The default is false.
        public bool Handled { get; set; }
        //
        // Summary:
        //     Gets whether the System.Windows.UIElement.ManipulationDelta event occurs
        //     during inertia.
        //
        // Returns:
        //     true if the System.Windows.UIElement.ManipulationDelta event occurs during
        //     inertia; false if the event occurs while the user's input device has contact
        //     with the element.
        public bool IsInertial { get; }
        //
        // Summary:
        //     Gets the container that defines the coordinates for the manipulation.
        //
        // Returns:
        //     The container element.
        public UIElement ManipulationContainer { get; }
        //
        // Summary:
        //     Gets the point from which the manipulation originated.
        //
        // Returns:
        //     The point from which the manipulation originated.
        public Point ManipulationOrigin { get; }
        //
        // Summary:
        //     Gets the rates of the most recent changes to the manipulation.
        //
        // Returns:
        //     The rates of the most recent changes to the manipulation.
        public ManipulationVelocities Velocities { get; }

        // Summary:
        //     Completes the manipulation without inertia.
        public void Complete();
    }
           其属性除了与ManipulationStartedEventArgs相同属性和方法之外,还多了以下几个属性:
           CumulativeManipulation属性:ManipulationDelta类型,返回当前操作的累积变化。
           DeltaManipulation属性:ManipulationDelta类型,返回当前操纵的最近期的变化。
           IsInertial属性:Bool类型,返回事件是否发生在惯性。如果为true,如果事件发生在惯性(即连续性);如果false,则与用户的输入设备有联系。
           Velocities属性:ManipulationVelocities类型,操纵的最近期的变化率。

•  ManipulationCompleted事件:当手指释放触摸屏时发生,可以通过事件并调用ManipulationCompletedEventArgs的相关方法进行处理。
  ManipulationCompletedEventArgs属性
    // Summary:
    //     Provides data for the System.Windows.UIElement.ManipulationCompleted event.
    public sealed class ManipulationCompletedEventArgs : RoutedEventArgs
    {
        // Summary:
        //     Initializes a new instance of the System.Windows.Input.ManipulationCompletedEventArgs
        //     class.
        public ManipulationCompletedEventArgs();

        // Summary:
        //     Gets the velocities that are used for the manipulation.
        //
        // Returns:
        //     The velocities that are used for the manipulation.
        public ManipulationVelocities FinalVelocities { get; }
        //
        // Summary:
        //     Gets or sets a value that marks the routed event as handled. Setting to true
        //     prevents most handlers along the event route from handling the same event
        //     again.
        //
        // Returns:
        //     true to mark the routed event handled; false to leave the routed event unhandled,
        //     which permits the event to potentially route further. The default is false.
        public bool Handled { get; set; }
        //
        // Summary:
        //     Gets whether the System.Windows.UIElement.ManipulationCompleted event occurs
        //     during inertia.
        //
        // Returns:
        //     true if the System.Windows.UIElement.ManipulationCompleted event occurs during
        //     inertia; false if the event occurs while the user's input device has contact
        //     with the element.
        public bool IsInertial { get; }
        //
        // Summary:
        //     Gets the container that defines the coordinates for the manipulation.
        //
        // Returns:
        //     The container element.
        public UIElement ManipulationContainer { get; }
        //
        // Summary:
        //     Gets the point from which the manipulation originated.
        //
        // Returns:
        //     The point from which the manipulation originated.
        public Point ManipulationOrigin { get; }
        //
        // Summary:
        //     Gets the total transformation that occurs during the current manipulation.
        //
        // Returns:
        //     The total transformation that occurs during the current manipulation.
        public ManipulationDelta TotalManipulation { get; }
    }
        ManipulationCompletedEventArgs的属性在前面已经出现,在此不在重复说明。


 
路由事件:
       所谓的路由事件是指UI层里面,这个事件会一层层从由里向外传播。例如:
UI代码:
<phone:PhoneApplicationPage>
     <Grid x:Name="ContentPanel"   ManipulationStarted="ContentPanel_ManipulationStarted">
        <TextBox Name="tbShow" ManipulationCompleted="tbShow_ManipulationCompleted>
        </TextBox>
     </Grid>
</phone:PhoneApplicationPage>
后台代码:
        private void tbShow_ManipulationStarted(object sender, ManipulationStartedEventArgs e)
        {
            //记录事件触发,调试是Output窗口可以看到打印信息,
            //如果没有打开Output窗口,在VS顶部菜单Deubug/Windows/Output可以打开。
            System.Diagnostics.Debug.WriteLine(DateTime.Now + " tbShow_ManipulationStarted \r\n");
        }

        /// <summary>
        /// TextBlock外层Grid的ManipulationStarted事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void ContentPanel_ManipulationStarted(object sender, ManipulationStartedEventArgs e)
        {
            System.Diagnostics.Debug.WriteLine(DateTime.Now + " ContentPanel_ManipulationStarted \r\n");   //记录事件触发
        }

        /// <summary>
        /// 重写Page的OnManipulationStarted事件
        /// </summary>
        /// <param name="e"></param>
        protected override void OnManipulationStarted(ManipulationStartedEventArgs e)
        {
            System.Diagnostics.Debug.WriteLine(DateTime.Now + " OnManipulationStarted \r\n");   //记录事件触发
        }
运行结果如下:
10/15/2011 5:25:53 PM tbShow_ManipulationStarted

10/15/2011 5:25:53 PM ContentPanel_ManipulationStarted

10/15/2011 5:25:53 PM OnManipulationStarted
由上面结果可以看出,ManipulationStarted是从里向外传播,如果要防止传播,只要设置Handled=true即可。

 

 

 

 

具体Demo代码如下: http://up.2cto.com/2011/1017/20111017113721781.rar

作者:刘付灵(Foolin)