Form.AcceptButton Form.AcceptButton Form.AcceptButton Form.AcceptButton Property

定義

ユーザーが Enter キーを押したときにクリックされる、フォーム上のボタンを取得または設定します。Gets or sets the button on the form that is clicked when the user presses the ENTER key.

public:
 property System::Windows::Forms::IButtonControl ^ AcceptButton { System::Windows::Forms::IButtonControl ^ get(); void set(System::Windows::Forms::IButtonControl ^ value); };
public System.Windows.Forms.IButtonControl AcceptButton { get; set; }
member this.AcceptButton : System.Windows.Forms.IButtonControl with get, set
Public Property AcceptButton As IButtonControl

プロパティ値

フォームの [確定] ボタンとして使用するボタンを表す IButtonControlAn IButtonControl that represents the button to use as the accept button for the form.

次の例では、Form の新しいインスタンスを作成し、ShowDialog メソッドを呼び出してフォームをダイアログボックスとして表示します。The following example creates a new instance of a Form and calls the ShowDialog method to display the form as a dialog box. この例では、FormBorderStyleAcceptButtonCancelButtonMinimizeBoxMaximizeBox、および StartPosition の各プロパティを設定して、フォームの外観と機能をダイアログボックスに変更します。The example sets the FormBorderStyle, AcceptButton, CancelButton, MinimizeBox, MaximizeBox, and StartPosition properties to change the appearance and functionality of the form to a dialog box. また、この例では、フォームの @no__t コレクションの Add メソッドを使用して、2つの @no__t 2 つのコントロールを追加しています。The example also uses the Add method of the form's Controls collection to add two Button controls. この例では、HelpButton プロパティを使用して、ダイアログボックスのキャプションバーに [ヘルプ] ボタンを表示します。The example uses the HelpButton property to display a help button in the caption bar of the dialog box.

public:
   void CreateMyForm()
   {
      // Create a new instance of the form.
      Form^ form1 = gcnew Form;
      // Create two buttons to use as the accept and cancel buttons.
      Button^ button1 = gcnew Button;
      Button^ button2 = gcnew Button;
      
      // Set the text of button1 to "OK".
      button1->Text = "OK";
      // Set the position of the button on the form.
      button1->Location = 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 =
         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();
   }
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();
}
Public Sub CreateMyForm()
    ' Create a new instance of the form.
    Dim form1 As New Form()
    ' Create two buttons to use as the accept and cancel buttons.
    Dim button1 As New Button()
    Dim button2 As 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()
End Sub

注釈

このプロパティを使用すると、ユーザーがアプリケーションで ENTER キーを押したときに実行される既定のアクションを指定できます。This property enables you to designate a default action to occur when the user presses the ENTER key in your application. このプロパティに割り当てられたボタンは、現在のフォームにあるか、現在のフォームのコンテナー内にある @no__t 0 である必要があります。The button assigned to this property must be an IButtonControl that is on the current form or located within a container on the current form.

このプロパティを使用すると、ユーザーがマウスで [同意] ボタンを手動でクリックするのではなく、入力が終わったときに ENTER キーを押すだけで、単純なフォームをすばやく移動できます。You can use this property to allow the user to quickly navigate a simple form by allowing them to simply press the ENTER key when they are finished instead of manually clicking the accept button with their mouse.

フォームで現在選択されているコントロールが ENTER キーをインターセプトして処理する場合、[accept] ボタンがアクティブにならないことがあります。The accept button might not be activated if the currently selected control on the form intercepts the ENTER key and processes it. たとえば、複数行テキストボックスコントロールを使用すると、コントロールに改行文字を挿入するように選択したときに ENTER キーを押すことができます。For example, a multiline text box control allows the ENTER key to be pressed when it is selected to insert a new line character in the control.

適用対象

こちらもご覧ください