Form.FormClosing イベント

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

Form.FormClosing イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

フォームが閉じる前に発生します。

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

Visual Basic (宣言)

Public Event FormClosing As
 FormClosingEventHandler

Visual Basic (使用法)

Dim instance As Form
Dim handler As FormClosingEventHandler

AddHandler instance.FormClosing, handler

C#

public event FormClosingEventHandler FormClosing

C++

public:
event FormClosingEventHandler^ FormClosing {
    void add (FormClosingEventHandler^ value);
    void remove (FormClosingEventHandler^ value);
}

J#

/** @event */
public void add_FormClosing (FormClosingEventHandler
 value)

/** @event */
public void remove_FormClosing (FormClosingEventHandler
 value)

JScript

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

解説

FormClosing イベントは、フォームが閉じている間に発生します。フォームが閉じられると、そのフォームは破棄され、関連付けられたすべてのリソースが解放されます。このイベントをキャンセルすると、フォームは開いたままになります。フォームを閉じる操作をキャンセルするには、イベント ハンドラに渡される FormClosingEventArgs の Cancel プロパティを true に設定します。

フォームがモーダル ダイアログ ボックスとして表示されている場合、閉じるボタン (フォームの右上隅の X が付いているボタン) をクリックするとフォームが非表示になり、DialogResult プロパティが DialogResult.Cancel に設定されます。ユーザーが閉じるボタンをクリックしたときに DialogResult プロパティに割り当てられる値をオーバーライドするには、フォームの FormClosing イベントのイベント ハンドラで DialogResult プロパティを設定します。

メモ
モードレス ウィンドウとして表示されている Form で Close メソッドが呼び出された場合は、フォームのリソースが既に解放されているため、Show メソッドを呼び出してフォームを表示することはできません。フォームを非表示にした後で表示するには、Hide メソッドを使用します。

フォームがマルチ ドキュメント インターフェイス (MDI) 親フォームの場合は、MDI 親フォームの FormClosing イベントが発生する前に、すべての MDI 子フォームの FormClosing イベントが発生します。同様に、MDI 親フォームの FormClosed イベントが発生する前に、すべての MDI 子フォームの FormClosed イベントが発生します。MDI 子フォームの FormClosing イベントをキャンセルしても、MDI 親フォームの FormClosing イベントは発生します。ただし、このイベントをキャンセルすると、親フォームにパラメータとして渡される FormClosingEventArgs クラスの Cancel プロパティは true に設定されます。MDI 親フォームおよび MDI 子フォームのすべてを強制的に閉じるには、MDI 親フォームの Cancel プロパティを false に設定します。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Form クラス
Form メンバ
System.Windows.Forms 名前空間
Form.IsMdiContainer プロパティ
Close
Hide
OnFormClosing
Form.FormClosed イベント
Load
Shown