Form.AcceptButton 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

Form.cs

获取或设置当用户按 Enter 键时所单击的窗体上的按钮。

C#

public System.Windows.Forms.IButtonControl? AcceptButton { get; set; }

属性值

IButtonControl

IButtonControl，表示要用作窗体的“接受”按钮的按钮。

示例

以下示例创建 的新实例 Form ，并调用 ShowDialog 方法将窗体显示为对话框。 该示例设置 FormBorderStyle、 AcceptButton、 CancelButton、 MinimizeBox、 MaximizeBox和 StartPosition 属性，以将窗体的外观和功能更改为对话框。 该示例还使用 Add 窗体集合的 Controls 方法添加两个 Button 控件。 该示例使用 HelpButton 属性在对话框的标题栏中显示帮助按钮。

C#

public void CreateMyForm()
{
   // Create a new instance of the form.
   Form form1 = new Form();
   // Create two buttons to use as the accept and cancel buttons.
   Button button1 = new Button ();
   Button button2 = new Button ();
  
   // Set the text of button1 to "OK".
   button1.Text = "OK";
   // Set the position of the button on the form.
   button1.Location = new Point (10, 10);
   // Set the text of button2 to "Cancel".
   button2.Text = "Cancel";
   // Set the position of the button based on the location of button1.
   button2.Location
      = new Point (button1.Left, button1.Height + button1.Top + 10);
   // Set the caption bar text of the form.   
   form1.Text = "My Dialog Box";
   // Display a help button on the form.
   form1.HelpButton = true;

   // Define the border style of the form to a dialog box.
   form1.FormBorderStyle = FormBorderStyle.FixedDialog;
   // Set the MaximizeBox to false to remove the maximize box.
   form1.MaximizeBox = false;
   // Set the MinimizeBox to false to remove the minimize box.
   form1.MinimizeBox = false;
   // Set the accept button of the form to button1.
   form1.AcceptButton = button1;
   // Set the cancel button of the form to button2.
   form1.CancelButton = button2;
   // Set the start position of the form to the center of the screen.
   form1.StartPosition = FormStartPosition.CenterScreen;
   
   // Add button1 to the form.
   form1.Controls.Add(button1);
   // Add button2 to the form.
   form1.Controls.Add(button2);
   
   // Display the form as a modal dialog box.
   form1.ShowDialog();
}

注解

此属性使你能够指定当用户在应用程序中按 Enter 键时要执行的默认操作。 分配给此属性的按钮必须是 IButtonControl 当前窗体上或位于当前窗体上的容器内的 。

可以使用此属性让用户在完成时只需按 Enter 键，而不是用鼠标手动单击接受按钮，从而允许用户快速导航简单窗体。

如果窗体上当前选定的控件截获并处理 ENTER 键，则“接受”按钮可能不会激活。 例如，多行文本框控件允许在选择在控件中插入新行字符时按 Enter 键。

适用于

另请参阅

• CancelButton
• IButtonControl