Form.Closing イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Form.Closing イベント

フォームが閉じている間に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event Closing As
 CancelEventHandler

Visual Basic (使用法)

Dim instance As Form
Dim handler As CancelEventHandler

AddHandler instance.Closing, handler

public event CancelEventHandler Closing

C++

public:
event CancelEventHandler^ Closing {
    void add (CancelEventHandler^ value);
    void remove (CancelEventHandler^ value);
}

/** @event */
public void add_Closing (CancelEventHandler
 value)

/** @event */
public void remove_Closing (CancelEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

注意
Application.Exit メソッドが呼び出されてアプリケーションを終了する場合、Form.Closed イベントと Form.Closing イベントは発生しません。これらのイベントのいずれかに実行する必要がある検証コードがある場合は、Exit メソッドを呼び出す前に、開いている各フォームに対して Form.Close メソッドを個別に呼び出す必要があります。

注意

Application.Exit メソッドが呼び出されてアプリケーションを終了する場合、Form.Closed イベントと Form.Closing イベントは発生しません。これらのイベントのいずれかに実行する必要がある検証コードがある場合は、Exit メソッドを呼び出す前に、開いている各フォームに対して Form.Close メソッドを個別に呼び出す必要があります。

フォームが MDI 親フォームの場合は、MDI 親フォームの Closing イベントが発生する前に、すべての MDI 子フォームの Closing イベントが発生します。さらに、MDI 親フォームの Closed イベントが発生する前に、すべての MDI 子フォームの Closed イベントが発生します。MDI 子フォームの Closing イベントをキャンセルしても、MDI 親フォームの Closing イベントは発生します。ただし、このイベントをキャンセルすると、親フォームにパラメータとして渡される CancelEventArgs の Cancel プロパティは true に設定されます。MDI 親フォームおよび MDI 子フォームのすべてを強制的に閉じるには、MDI 親フォームの Cancel プロパティを true に設定します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Visual Basic

   Private Sub Form1_Closing(sender As
 Object, e As System.ComponentModel.CancelEventArgs)
 Handles MyBase.Closing
      ' Determine if text has changed in the textbox by comparing to
 original text.
      If textBox1.Text <> strMyOriginalText Then
         ' Display a MsgBox asking the user to save changes or abort.
         If MessageBox.Show("Do you want to
 save changes to your text?", "My Application",
 MessageBoxButtons.YesNo) = DialogResult.Yes Then
            ' Cancel the Closing event from closing the form.
            e.Cancel = True
         End If ' Call method
 to save file...
      End If
   End Sub 'Form1_Closing
End Class 'Form1

private void Form1_Closing(object sender, System.ComponentModel.CancelEventArgs
 e)
{
   // Determine if text has changed in the textbox by comparing to original
 text.
   if (textBox1.Text != strMyOriginalText)
   {
      // Display a MsgBox asking the user to save changes or abort.
      if(MessageBox.Show("Do you want to save changes to
 your text?", "My Application",
         MessageBoxButtons.YesNo) ==  DialogResult.Yes)
      {
         // Cancel the Closing event from closing the form.
         e.Cancel = true;
         // Call method to save file...
      }
   }
}

C++

private:
   void Form1_Closing( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^
 e )
   {
      // Determine if text has changed in the textbox by comparing to original
 text.
      if ( textBox1->Text != strMyOriginalText )
      {
         // Display a MsgBox asking the user to save changes or abort.
         if ( MessageBox::Show( "Do you want to save changes
 to your text?", "My Application", MessageBoxButtons::YesNo ) ==
 ::DialogResult::Yes )
         {
            // Cancel the Closing event from closing the form.
            e->Cancel = true;

            // Call method to save file...
         }
      }
   }

private void Form1Closing(Object sender,
    System.ComponentModel.CancelEventArgs e)
{
    // Determine if text has changed in the textbox by comparing to
 
    // original text.
    if (textBox1.get_Text() != strMyOriginalText) {
        // Display a MsgBox asking the user to save changes or abort.
        if (MessageBox.Show("Do you want to save changes
 to your text?",
            "My Application", MessageBoxButtons.YesNo).Equals(
            get_DialogResult().Yes)) {
            // Cancel the Closing event from closing the form.
            e.set_Cancel(true);
            // Call method to save file...
        }
    }
} //Form1Closing