Form.DialogResult 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
폼에 대한 대화 상자 결과를 가져오거나 설정합니다.
public:
property System::Windows::Forms::DialogResult DialogResult { System::Windows::Forms::DialogResult get(); void set(System::Windows::Forms::DialogResult value); };[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DialogResult DialogResult { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.DialogResult : System.Windows.Forms.DialogResult with get, setPublic Property DialogResult As DialogResult속성 값
DialogResult 대화 상자로 사용될 때 폼의 결과를 나타내는 A입니다.
- 특성
예외
지정된 값이 유효한 값 범위를 벗어났습니다.
예제
다음은 폼을 대화 상자로 표시하고 폼의 속성을 참조 DialogResult 하여 폼의 확인 또는 취소 단추를 클릭했는지 여부를 나타내는 메시지 상자를 표시하는 예제입니다.
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);
// Make button1's dialog result OK.
button1->DialogResult = ::DialogResult::OK;
// Make button2's dialog result Cancel.
button2->DialogResult = ::DialogResult::Cancel;
// Set the caption bar text of the form.
form1->Text = "My Dialog Box";
// Define the border style of the form to a dialog box.
form1->FormBorderStyle = ::FormBorderStyle::FixedDialog;
// 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();
// Determine if the OK button was clicked on the dialog box.
if ( form1->DialogResult == ::DialogResult::OK )
{
// Display a message box indicating that the OK button was clicked.
MessageBox::Show( "The OK button on the form was clicked." );
// Optional: Call the Dispose method when you are finished with the dialog box.
delete form1;
}
else
{
// Display a message box indicating that the Cancel button was clicked.
MessageBox::Show( "The Cancel button on the form was clicked." );
// Optional: Call the Dispose method when you are finished with the dialog box.
delete form1;
}
}
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);
// Make button1's dialog result OK.
button1.DialogResult = DialogResult.OK;
// Make button2's dialog result Cancel.
button2.DialogResult = DialogResult.Cancel;
// Set the caption bar text of the form.
form1.Text = "My Dialog Box";
// Define the border style of the form to a dialog box.
form1.FormBorderStyle = FormBorderStyle.FixedDialog;
// 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();
// Determine if the OK button was clicked on the dialog box.
if (form1.DialogResult == DialogResult.OK)
{
// Display a message box indicating that the OK button was clicked.
MessageBox.Show("The OK button on the form was clicked.");
// Optional: Call the Dispose method when you are finished with the dialog box.
form1.Dispose();
}
else
{
// Display a message box indicating that the Cancel button was clicked.
MessageBox.Show("The Cancel button on the form was clicked.");
// Optional: Call the Dispose method when you are finished with the dialog box.
form1.Dispose();
}
}
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)
' Make button1's dialog result OK.
button1.DialogResult = DialogResult.OK
' Make button2's dialog result Cancel.
button2.DialogResult = DialogResult.Cancel
' Set the caption bar text of the form.
form1.Text = "My Dialog Box"
' Define the border style of the form to a dialog box.
form1.FormBorderStyle = FormBorderStyle.FixedDialog
' 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()
' Determine if the OK button was clicked on the dialog box.
If form1.DialogResult = DialogResult.OK Then
' Display a message box indicating that the OK button was clicked.
MessageBox.Show("The OK button on the form was clicked.")
' Optional: Call the Dispose method when you are finished with the dialog box.
form1.Dispose
' Display a message box indicating that the Cancel button was clicked.
Else
MessageBox.Show("The Cancel button on the form was clicked.")
' Optional: Call the Dispose method when you are finished with the dialog box.
form1.Dispose
End If
End Sub
설명
폼의 대화 결과는 폼이 모달 대화 상자로 표시될 때 폼에서 반환되는 값입니다. 폼이 대화 상자로 표시되면 이 속성을 열거형의 DialogResult 값으로 설정하면 폼에 대한 대화 상자 결과의 값이 설정되고 모달 대화 상자가 숨겨지고 컨트롤이 호출 폼으로 반환됩니다. 이 속성은 일반적으로 폼의 DialogResult 컨트롤 속성 Button 에 의해 설정됩니다. 사용자가 컨트롤을 Button 클릭하면 속성 Button 에 DialogResult 할당된 값이 양식의 속성에 DialogResult 할당됩니다.
폼이 모달 대화 상자로 표시되면 닫기 단추(폼의 오른쪽 위 모서리에 X가 있는 단추)를 클릭하면 폼이 숨겨지고 속성이 DialogResult 설정 DialogResult.Cancel됩니다.
Close 사용자가 대화 상자의 닫기 단추를 클릭하거나 속성 값을 DialogResult 설정하면 메서드가 자동으로 호출되지 않습니다. 대신 폼이 숨겨지고 대화 상자의 새 인스턴스를 만들지 않고 다시 표시할 수 있습니다. 이 동작으로 인해 애플리케이션에서 양식이 Dispose 더 이상 필요하지 않은 경우 양식의 메서드를 호출해야 합니다.
이 속성을 사용 하 여 대화 상자에서 수행 하는 작업을 제대로 처리 하기 위해 대화 상자를 닫는 방법을 결정할 수 있습니다.
메모
사용자가 폼의 이벤트에 대한 이벤트 처리기에서 속성을 설정 DialogResult 하여 닫기 단추를 클릭할 때 속성에 Closing 할당된 DialogResult 값을 재정의할 수 있습니다.
메모
모 Form 덜리스 창으로 표시되는 경우 양식이 닫히면 양식의 리소스가 자동으로 해제되므로 속성에서 반환 DialogResult 하는 값이 양식에 할당된 값을 반환하지 않을 수 있습니다.
