Form.CancelButton Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Form.cs

Získá nebo nastaví ovládací prvek tlačítka, který je kliknut, když uživatel stiskne klávesu ESC.

public:
 property System::Windows::Forms::IButtonControl ^ CancelButton { System::Windows::Forms::IButtonControl ^ get(); void set(System::Windows::Forms::IButtonControl ^ value); };

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

member this.CancelButton : System.Windows.Forms.IButtonControl with get, set

Public Property CancelButton As IButtonControl

Hodnota vlastnosti

IButtonControl

Jedná se o IButtonControl tlačítko pro zrušení formuláře.

Příklady

Následující příklad vytvoří novou instanci a Form zavolá metodu ShowDialog , která zobrazí formulář jako dialogové okno. Příklad nastaví FormBorderStyle, , AcceptButton, CancelButtonMinimizeBox, MaximizeBox, a StartPosition vlastnosti změnit vzhled a funkce formuláře na dialogové okno. Příklad také používá Add metodu kolekce formuláře Controls k přidání dvou Button ovládacích prvků. Příklad používá HelpButton vlastnost k zobrazení tlačítka nápovědy na panelu titulků dialogového okna.

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

Poznámky

Tlačítko Zrušit pro formulář je ovládací prvek tlačítka, který se kliká pokaždé, když uživatel stiskne klávesu ESC. Tlačítko přiřazené k této vlastnosti musí být ten IButtonControl , který je v aktuálním formuláři nebo umístěný v kontejneru v aktuálním formuláři.

Tato vlastnost umožňuje určit výchozí akci, která se má provést, když uživatel v aplikaci stiskne klávesu ESC. Pomocí této vlastnosti můžete uživateli umožnit rychlou navigaci v jednoduchém formuláři tak, že mu umožníte jednoduše stisknout klávesu ESC a zavřít okno, aniž byste museli ručně kliknout na tlačítko Zrušit pomocí myši.

CancelButton může fungovat, pokud jiný ovládací prvek ve formuláři zachytí klávesu ESC. Pokud ComboBox máte například otevřený formulář, esc zavře místo ComboBox zavření formuláře.

Objekt IButtonControl přiřazený CancelButton k formuláři musí být viditelný nebo jinak stisknutí klávesy ESC nebude mít žádný vliv.

Viz také

• AcceptButton
• IButtonControl