Form.FormClosing イベント

定義

フォームが閉じる前に発生します。Occurs before the form is closed.

public:
 event System::Windows::Forms::FormClosingEventHandler ^ FormClosing;
public event System.Windows.Forms.FormClosingEventHandler FormClosing;
member this.FormClosing : System.Windows.Forms.FormClosingEventHandler 
Public Custom Event FormClosing As FormClosingEventHandler 

イベントの種類

FormClosingEventHandler

このメンバーの使用例を次に示します。The following example demonstrates the use of this member. この例では、イベントハンドラーがイベントの発生を報告し FormClosing ます。In the example, an event handler reports on the occurrence of the FormClosing event. このレポートは、イベントがいつ発生し、デバッグに役立つかを理解するのに役立ちます。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントについてレポートするには、メッセージをに置き換えるか、または複数 MessageBox.Show Console.WriteLine 行に追加することを検討してください TextBoxTo report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行するには、という名前の型のインスタンスを含むプロジェクトに貼り付け Form Form1 ます。To run the example code, paste it into a project that contains an instance of type Form named Form1. 次に、イベントハンドラーがイベントに関連付けられていることを確認し FormClosing ます。Then ensure that the event handler is associated with the FormClosing event.

private void Form1_FormClosing(Object sender, FormClosingEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "FormClosing Event" );
}
Private Sub Form1_FormClosing(sender as Object, e as FormClosingEventArgs) _ 
     Handles Form1.FormClosing

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"FormClosing Event")

End Sub

注釈

イベントは、 FormClosing フォームが閉じられているときに発生します。The FormClosing event occurs as the form is being closed. フォームが閉じられると、フォームに関連付けられているすべてのリソースが解放され、破棄されます。When a form is closed, it is disposed, releasing all resources associated with the form. このイベントを取り消すと、フォームは開いたままになります。If you cancel this event, the form remains opened. フォームのクロージャを取り消すには、 Cancel FormClosingEventArgs イベントハンドラーに渡されたのプロパティをに設定し true ます。To cancel the closure of a form, set the Cancel property of the FormClosingEventArgs passed to your event handler to true.

フォームがモーダルダイアログボックスとして表示されている場合、[ 閉じる ] ボタン (フォームの右上隅にある [X]) をクリックすると、フォームが非表示になり、 DialogResult プロパティがに設定され DialogResult.Cancel ます。When a form is displayed as a modal dialog box, clicking the Close button (the button with an X at the upper-right corner of the form) causes the form to be hidden and the DialogResult property to be set to DialogResult.Cancel. DialogResult Close DialogResult フォームのイベントに対してイベントハンドラーのプロパティを設定することによって、ユーザーが [閉じる] ボタンをクリックしたときに、プロパティに割り当てられた値をオーバーライドできます FormClosingYou can override the value assigned to the DialogResult property when the user clicks the Close button by setting the DialogResult property in an event handler for the FormClosing event of the form.

注意

Closeモードレスウィンドウとして表示されたに対してメソッドが呼び出された場合、 Form Show フォームのリソースは既に解放されているため、メソッドを呼び出してフォームを表示することはできません。When the Close method is called on a Form displayed as a modeless window, you cannot call the Show method to make the form visible, because the form's resources have already been released. フォームを非表示にしてから表示できるようにするには、メソッドを使用し Hide ます。To hide a form and then make it visible, use the Hide method.

フォームがマルチドキュメントインターフェイス (MDI) 親フォームである場合、mdi FormClosing 親フォームのイベントが発生する前に、すべての mdi 子フォームのイベントが発生し FormClosing ます。If the form is a multiple-document interface (MDI) parent form, the FormClosing events of all MDI child forms are raised before the MDI parent form's FormClosing event is raised. 同様に、mdi FormClosed FormClosed 親フォームのイベントが発生する前に、すべての mdi 子フォームのイベントが発生します。Likewise, the FormClosed events of all MDI child forms are raised before the FormClosed event of the MDI parent form is raised. FormClosingMdi 子フォームのイベントをキャンセルしても、 FormClosing mdi 親フォームのイベントが発生するのを防ぐことはできません。Canceling the FormClosing event of an MDI child form does not prevent the FormClosing event of the MDI parent form from being raised. ただし、イベントを取り消すと、 true Cancel FormClosingEventArgs 親フォームにパラメーターとして渡されるクラスのプロパティに設定されます。However, canceling the event will set to true the Cancel property of the FormClosingEventArgs class that is passed as a parameter to the parent form. すべての MDI 親フォームと子フォームを強制的に閉じられるようにするには、 Cancel mdi 親フォームでプロパティをに設定し false ます。To force all MDI parent and child forms to close, set the Cancel property to false in the MDI parent form.

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。For more information about handling events, see Handling and Raising Events.

適用対象

こちらもご覧ください