通过

添加点击手势识别器

  • 项目

点击手势用于点击检测，可通过 TapGestureRecognizer 类实现。

若要让某个用户界面元素可以使用点击手势进行点击，请创建 TapGestureRecognizer 实例，处理 Tapped 事件，并将新的手势识别器添加到该用户界面元素上的 GestureRecognizers 集合。 以下代码示例展示了附加到 Image 元素的 TapGestureRecognizer：

var tapGestureRecognizer = new TapGestureRecognizer();
tapGestureRecognizer.Tapped += (s, e) => {
    // handle the tap
};
image.GestureRecognizers.Add(tapGestureRecognizer);

默认情况下，该图像将响应单击。 请将 NumberOfTapsRequired 属性设置为等待双击（必要时可设置为等待更多次点击）。

tapGestureRecognizer.NumberOfTapsRequired = 2; // double-tap

当 NumberOfTapsRequired 设置为高于 1 时，只有在设定的时间段（此时间段不可配置）内进行点击时才会执行事件处理程序。 如果在该时间段内没有进行第二次（或后续）点击，系统会有效地忽略它们并重新启动“点击计数”。

使用 XAML

可以使用附加属性将手势识别器添加到 XAML 中的控件。 向图像添加 TapGestureRecognizer 的语法如下所示（在本例中定义了双击事件）：

<Image Source="tapped.jpg">
    <Image.GestureRecognizers>
        <TapGestureRecognizer
                Tapped="OnTapGestureRecognizerTapped"
                NumberOfTapsRequired="2" />
  </Image.GestureRecognizers>
</Image>

事件处理程序的代码（在示例中）对计数器进行递增，并将图像从彩色更改为黑色和白色。

void OnTapGestureRecognizerTapped(object sender, EventArgs args)
{
    tapCount++;
    var imageSender = (Image)sender;
    // watch the monkey go from color to black&white!
    if (tapCount % 2 == 0) {
        imageSender.Source = "tapped.jpg";
    } else {
        imageSender.Source = "tapped_bw.jpg";
    }
}

使用 ICommand

使用模型-视图-视图模型 (MVVM) 模式的应用程序通常使用 ICommand，而不是直接绑定事件处理程序。 TapGestureRecognizer 可轻松地支持 ICommand，方法为在代码中设置绑定：

var tapGestureRecognizer = new TapGestureRecognizer();
tapGestureRecognizer.SetBinding (TapGestureRecognizer.CommandProperty, "TapCommand");
image.GestureRecognizers.Add(tapGestureRecognizer);

或使用 XAML：

<Image Source="tapped.jpg">
    <Image.GestureRecognizers>
        <TapGestureRecognizer
            Command="{Binding TapCommand}"
            CommandParameter="Image1" />
    </Image.GestureRecognizers>
</Image>

可以在示例中找到此视图模型的完整代码。 相关的 Command 实现细节如下所示：

public class TapViewModel : INotifyPropertyChanged
{
    int taps = 0;
    ICommand tapCommand;
    public TapViewModel () {
        // configure the TapCommand with a method
        tapCommand = new Command (OnTapped);
    }
    public ICommand TapCommand {
        get { return tapCommand; }
    }
    void OnTapped (object s)  {
        taps++;
        Debug.WriteLine ("parameter: " + s);
    }
    //region INotifyPropertyChanged code omitted
}