Freigeben über


So unterscheiden Sie zwischen Klicks und Doppelklicks

In der Regel initiiert ein einzelner Klick eine Benutzeroberflächenaktion, und ein Doppelklick erweitert die Aktion. Beispielsweise wählt ein Klick in der Regel ein Element aus, und mit einem Doppelklick wird das ausgewählte Element bearbeitet. Die Windows Forms-Klickereignisse lassen sich jedoch nicht leicht in ein Szenario integrieren, in dem ein Klick und ein Doppelklick inkompatible Aktionen ausführen, da eine Aktion, die mit dem Click- oder MouseClick-Ereignis verknüpft ist, vor der Aktion ausgeführt wird, die mit dem DoubleClick- oder MouseDoubleClick-Ereignis verknüpft ist. In diesem Thema werden zwei Lösungen für dieses Problem veranschaulicht.

Eine Lösung besteht darin, das Doppelklick-Ereignis zu behandeln und die Aktionen bei der Behandlung des Klick-Ereignisses rückgängig zu machen. In seltenen Situationen müssen Sie möglicherweise das Verhalten von Klick und Doppelklick simulieren, indem Sie das MouseDown Ereignis behandeln und die DoubleClickTimeDoubleClickSize Eigenschaften der SystemInformation Klasse verwenden. Sie messen die Zeit zwischen Klicks und wenn ein zweiter Klick eintritt, bevor der Wert erreicht DoubleClickTime wird und sich der Klick innerhalb eines durch DoubleClickSizedefinierten Rechtecks befindet, führen Sie die Doppelklickaktion aus. Andernfalls führen Sie die Klickaktion aus.

So machen Sie eine Klickaktion rückgängig

Stellen Sie sicher, dass das Steuerelement, mit dem Sie arbeiten, über ein standardmäßiges Doppelklickverhalten verfügt. Wenn nicht, aktivieren Sie das Steuerelement mit der SetStyle Methode. Behandeln Sie das Doppelklickereignis, und führen Sie einen Rollback der Klickaktion sowie der Doppelklickaktion durch. Das folgende Codebeispiel veranschaulicht das Erstellen einer benutzerdefinierten Schaltfläche mit aktiviertem Doppelklick sowie das Zurücksetzen der Klickaktion im Code für die Ereignisbehandlung mit Doppelklick.

In diesem Codebeispiel wird ein neues Schaltflächensteuerelement verwendet, das Doppelklicks ermöglicht:

public partial class DoubleClickButton : Button
{
    public DoubleClickButton()
    {
        // Set the style so a double click event occurs.
        SetStyle(ControlStyles.StandardClick | ControlStyles.StandardDoubleClick, true);
    }
}
Public Class DoubleClickButton : Inherits Button

    Public Sub New()
        SetStyle(ControlStyles.StandardClick Or ControlStyles.StandardDoubleClick, True)
    End Sub

End Class

Der folgende Code veranschaulicht, wie ein Formular das Format des Rahmens auf der Grundlage eines Klicks oder Doppelklickens des neuen Schaltflächensteuerelements ändert:

public partial class Form1 : Form
{
    private FormBorderStyle _initialStyle;
    private bool _isDoubleClicking;

    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        _initialStyle = this.FormBorderStyle;

        var button1 = new DoubleClickButton();
        button1.Location = new Point(50, 50);
        button1.Size = new Size(200, 23);
        button1.Text = "Click or Double Click";
        button1.Click += Button1_Click;
        button1.DoubleClick += Button1_DoubleClick;

        Controls.Add(button1);
    }

    private void Button1_DoubleClick(object sender, EventArgs e)
    {
        // This flag prevents the click handler logic from running
        // A double click raises the click event twice.
        _isDoubleClicking = true;
        FormBorderStyle = _initialStyle;
    }

    private void Button1_Click(object sender, EventArgs e)
    {
        if (_isDoubleClicking)
            _isDoubleClicking = false;
        else
            FormBorderStyle = FormBorderStyle.FixedToolWindow;
    }
}
Partial Public Class Form1

    Private _initialStyle As FormBorderStyle
    Private _isDoubleClicking As Boolean

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        Dim button1 As New DoubleClickButton

        _initialStyle = FormBorderStyle

        button1.Location = New Point(50, 50)
        button1.Size = New Size(200, 23)
        button1.Text = "Click or Double Click"

        AddHandler button1.Click, AddressOf Button1_Click
        AddHandler button1.DoubleClick, AddressOf Button1_DoubleClick

        Controls.Add(button1)

    End Sub

    Private Sub Button1_DoubleClick(sender As Object, e As EventArgs)
        ' This flag prevents the click handler logic from running
        ' A double click raises the click event twice.
        _isDoubleClicking = True
        FormBorderStyle = _initialStyle
    End Sub

    Private Sub Button1_Click(sender As Object, e As EventArgs)
        If _isDoubleClicking Then
            _isDoubleClicking = False
        Else
            FormBorderStyle = FormBorderStyle.FixedToolWindow
        End If
    End Sub
End Class

So unterscheiden Sie zwischen Klicks

Behandeln Sie das MouseDown Ereignis, und bestimmen Sie den Ort und die Zeitspanne zwischen Klicks mithilfe der SystemInformation Eigenschaft und einer Timer Komponente. Führen Sie die entsprechende Aktion aus, je nachdem, ob ein Klick oder Doppelklick stattfindet. Im folgenden Codebeispiel wird veranschaulicht, wie dies möglich ist.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

namespace project
{
    public partial class Form2 : Form
    {
        private DateTime _lastClick;
        private bool _inDoubleClick;
        private Rectangle _doubleClickArea;
        private TimeSpan _doubleClickMaxTime;
        private Action _doubleClickAction;
        private Action _singleClickAction;
        private Timer _clickTimer;

        public Form2()
        {
            InitializeComponent();
            _doubleClickMaxTime = TimeSpan.FromMilliseconds(SystemInformation.DoubleClickTime);

            _clickTimer = new Timer();
            _clickTimer.Interval = SystemInformation.DoubleClickTime;
            _clickTimer.Tick += ClickTimer_Tick;

            _singleClickAction = () => MessageBox.Show("Single clicked");
            _doubleClickAction = () => MessageBox.Show("Double clicked");
        }

        private void Form2_MouseDown(object sender, MouseEventArgs e)
        {
            if (_inDoubleClick)
            {
                _inDoubleClick = false;

                TimeSpan length = DateTime.Now - _lastClick;

                // If double click is valid, respond
                if (_doubleClickArea.Contains(e.Location) && length < _doubleClickMaxTime)
                {
                    _clickTimer.Stop();
                    _doubleClickAction();
                }

                return;
            }

            // Double click was invalid, restart 
            _clickTimer.Stop();
            _clickTimer.Start();
            _lastClick = DateTime.Now;
            _inDoubleClick = true;
            _doubleClickArea = new Rectangle(e.Location - (SystemInformation.DoubleClickSize / 2), 
                                             SystemInformation.DoubleClickSize);
        }

        private void ClickTimer_Tick(object sender, EventArgs e)
        {
            // Clear double click watcher and timer
            _inDoubleClick = false;
            _clickTimer.Stop();

            _singleClickAction();
        }
    }
}
Imports System.Drawing
Imports System.Windows.Forms

Public Class Form2
    Private _lastClick As Date
    Private _inDoubleClick As Boolean
    Private _doubleClickArea As Rectangle
    Private _doubleClickMaxTime As TimeSpan
    Private _singleClickAction As Action
    Private _doubleClickAction As Action
    Private WithEvents _clickTimer As Timer

    Private Sub Form2_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        _doubleClickMaxTime = TimeSpan.FromMilliseconds(SystemInformation.DoubleClickTime)

        _clickTimer = New Timer()
        _clickTimer.Interval = SystemInformation.DoubleClickTime

        _singleClickAction = Sub()
                                 MessageBox.Show("Single click")
                             End Sub

        _doubleClickAction = Sub()
                                 MessageBox.Show("Double click")
                             End Sub
    End Sub

    Private Sub Form2_MouseDown(sender As Object, e As MouseEventArgs) Handles MyBase.MouseDown
        If _inDoubleClick Then

            _inDoubleClick = False

            Dim length As TimeSpan = Date.Now - _lastClick

            ' If double click is valid, respond
            If _doubleClickArea.Contains(e.Location) And length < _doubleClickMaxTime Then
                _clickTimer.Stop()
                Call _doubleClickAction()
            End If

            Return
        End If

        ' Double click was invalid, restart 
        _clickTimer.Stop()
        _clickTimer.Start()
        _lastClick = Date.Now
        _inDoubleClick = True
        _doubleClickArea = New Rectangle(e.Location - (SystemInformation.DoubleClickSize / 2),
                                         SystemInformation.DoubleClickSize)
    End Sub

    Private Sub SingleClickTimer_Tick(sender As Object, e As EventArgs) Handles _clickTimer.Tick
        ' Clear double click watcher and timer
        _inDoubleClick = False
        _clickTimer.Stop()

        Call _singleClickAction()
    End Sub

End Class

Siehe auch