Form.CancelButton 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
사용자가 ESC 키를 누를 때 클릭되는 Button 컨트롤을 가져오거나 설정합니다.
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; }public System.Windows.Forms.IButtonControl? CancelButton { get; set; }member this.CancelButton : System.Windows.Forms.IButtonControl with get, setPublic Property CancelButton As IButtonControl속성 값
폼의 취소 단추를 나타내는 IButtonControl입니다.
예제
다음 예제에서는 a의 새 인스턴스를 Form 만들고 메서드를 ShowDialog 호출하여 폼을 대화 상자로 표시합니다. 다음은 폼의 FormBorderStyle모양과 기능을 대화 상자로 변경하는 , MinimizeBoxMaximizeBoxAcceptButtonCancelButton및 StartPosition 속성을 설정하는 예제입니다. 이 예제에서는 폼 Controls 컬렉션의 메서드를 사용하여 Add 두 개의 Button 컨트롤을 추가합니다. 이 예제에서는 속성을 사용하여 HelpButton 대화 상자의 캡션 표시줄에 도움말 단추를 표시합니다.
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
설명
폼의 취소 단추는 사용자가 ESC 키를 누를 때마다 클릭하는 단추 컨트롤입니다. 이 속성에 할당된 단추는 현재 폼에 있거나 현재 폼의 컨테이너 내에 있어야 합니다 IButtonControl .
이 속성을 사용 하면 사용자가 애플리케이션에서 ESC 키를 누를 때 발생 하는 기본 동작을 지정할 수 있습니다. 이 속성을 사용하면 사용자가 마우스로 취소 단추를 수동으로 클릭하는 대신 변경 내용을 커밋하지 않고 ESC 키를 눌러 창을 닫을 수 있도록 하여 간단한 양식을 빠르게 탐색할 수 있습니다.
CancelButton 양식의 다른 컨트롤이 ESC 키를 가로채면 작동하지 않을 수 있습니다. 예를 들어 양식에 열려 있는 ComboBox 경우 ESC는 양식을 닫는 ComboBox 대신 닫습니다.
할당된 CancelButton 개체는 IButtonControl 폼에 표시되어야 합니다. 그렇지 않으면 ESC 키를 누르면 아무런 효과가 없습니다.