Button 按钮

按钮是一种对指针动作做出反应的控件（也有一些键盘等效操作）。当指针按下时，它会呈现出被按下的状态。

指针按下到释放的序列会解释为点击，并且此行为是可配置的。

注意

在确定按钮是否被用户按下时，请始终使用Click事件而不是PointerPressed。Click是Button特有的高级事件，表示按钮已被按下。

而PointerPressed更像是一个低层次的输入事件：Button需要在内部处理这个事件，以引发Click事件。由于 Button 会处理 PointerPressed事件（将IsHandled设为 true），应用程序将永远不会像其他控件那样收到该事件。

信息

点击是众多按钮事件之一，完整列表请参阅这里。

按钮可以在代码后台引发点击事件。或者，您可以将ICommand的实例绑定到Command属性。绑定的命令将在每次按钮被点击时执行。

信息

有关如何绑定到命令的指南，请参阅这里。

有用的属性

您可能最常用到以下属性：

属性	描述
ClickMode	描述按钮如何对点击做出反应。
Command	点击按钮时要调用的ICommand实例。

更多信息

以下示例展示了一个简单的按钮和一个C#代码后台的点击事件处理程序。

<StackPanel Margin="20">
  <Button Click="ClickHandler">Press Me!</Button>
  <TextBlock Margin="0 10" x:Name="message">Ready...</TextBlock>
</StackPanel>

C#

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    public void ClickHandler(object sender, RoutedEventArgs args)
    {
        message.Text = "Button clicked!";
    }
}

更多信息

信息

有关该控件的完整API文档，请参阅这里。

信息

在 GitHub 上查看源代码 Button.cs。