winform按钮控件设置单击和双击事件

### 在 C# WinForms 中为按钮添加单击和双击事件处理程序

为了实现这一目标，可以采用两种主要方式来定义这些事件处理器：通过可视化设计器或手动编写代码。

#### 使用 Visual Studio 可视化设计器

当在 Windows Forms 设计器中放置了一个 `Button` 控件之后：

- **单击事件**: 单击该按钮并进入属性面板，在“事件”部分找到 `Click` 事件，点击旁边的闪电图标选择要创建的新事件处理函数名。这会自动生成相应的事件处理方法模板[^2]。

- **双击事件**: 对于双击行为，默认情况下并没有直接提供 `DoubleClick` 的选项给 Button 控件。然而可以通过重写窗体的 `OnMouseDoubleClick` 方法或者订阅控件的 `MouseDown` 或者 `MouseUp` 事件，并检测鼠标按键次数来模拟此效果[^1]。

#### 手动编码实现

如果偏好编程方式，则可以直接向 Form 类文件内添加如下所示的代码片段:

// 定义单击事件处理程序
private void button_Click(object sender, EventArgs e)
{
    MessageBox.Show("Single Click!");
}

// 如果想要支持双击操作，需额外注册 MouseDown/Up 事件监听
private DateTime lastClickTime;
private const int DOUBLE_CLICK_TIME_MS = 500;

private void button_MouseDown(object sender, MouseEventArgs e)
{
    var currentTime = DateTime.Now;
    
    if ((currentTime - lastClickTime).TotalMilliseconds <= DOUBLE_CLICK_TIME_MS)
    {
        // 处理双击逻辑
        MessageBox.Show("Double Clicked!");
        
        // 清除时间戳以防连续触发多次双击判断
        lastClickTime = default(DateTime);
        return;
    }

    // 更新上次点击的时间戳
    lastClickTime = currentTime;
}

上述代码展示了如何区分单次点击与两次快速点击之间的差异，并据此执行不同的动作。需要注意的是，这里假设了两次有效点击之间最大间隔不超过500毫秒作为判定标准；实际开发过程中可根据需求调整这个阈值。