Button.DialogResult プロパティ

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

Button.DialogResult プロパティ

ボタンをクリックしたときに親フォームに返される値を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DialogResult As DialogResult

Visual Basic (使用法)

Dim instance As Button
Dim value As DialogResult

value = instance.DialogResult

instance.DialogResult = value

C#

public virtual DialogResult DialogResult { get;
 set; }

C++

public:
virtual property DialogResult DialogResult {
    DialogResult get ();
    void set (DialogResult value);
}

J#

/** @property */
public DialogResult get_DialogResult ()

/** @property */
public void set_DialogResult (DialogResult
 value)

JScript

public function get DialogResult
 () : DialogResult

public function set DialogResult
 (value : DialogResult)

プロパティ値
DialogResult 値の 1 つ。既定値は None です。

例外

例外の種類	条件
InvalidEnumArgumentException	代入された値が、DialogResult 値ではありません。

解説

このプロパティの DialogResult が None 以外の値に設定されており、親フォームが ShowDialog メソッドを使用して表示されている場合、ボタンをクリックすると親フォームが閉じます。ユーザーがイベントをフックする必要はありません。ボタンがクリックされると、フォームの DialogResult プロパティがボタンの DialogResult に設定されます。

たとえば、"はい/いいえ/キャンセル" のダイアログ ボックスを作成するには、3 つのボタンを追加し、各ボタンの DialogResult プロパティを Yes、No、および Cancel に設定します。

使用例

Button を作成し、その DialogResult プロパティを OK に設定して、Form に追加するコード例を次に示します。

Visual Basic

Private Sub InitializeMyButton()
    ' Create and initialize a Button.
    Dim button1 As New Button()
    
    ' Set the button to return a value of OK when clicked.
    button1.DialogResult = DialogResult.OK
    
    ' Add the button to the form.
    Controls.Add(button1)
End Sub 'InitializeMyButton

C#

private void InitializeMyButton()
 {
    // Create and initialize a Button.
    Button button1 = new Button();
 
    // Set the button to return a value of OK when clicked.
    button1.DialogResult = DialogResult.OK;
 
    // Add the button to the form.
    Controls.Add(button1);
 }
 

C++

private:
   void InitializeMyButton()
   {
      // Create and initialize a Button.
      Button^ button1 = gcnew Button;
      
      // Set the button to return a value of OK when clicked.
      button1->DialogResult = ::DialogResult::OK;
      
      // Add the button to the form.
      Controls->Add( button1 );
   }

J#

private void InitializeMyButton()
{
    // Create and initialize a Button.
    Button button1 = new Button();
    
    // Set the button to return a value of OK when clicked.
    button1.set_DialogResult(get_DialogResult().OK);
    
    // Add the button to the form.
    get_Controls().Add(button1);
} //InitializeMyButton

JScript

private function InitializeMyButton()
 {
    // Create and initialize a Button.
    var button1 : Button = new Button();
 
    // Set the button to return a value of OK when clicked.
    button1.DialogResult = System.Windows.Forms.DialogResult.OK;
 
    // Add the button to the form.
    Controls.Add(button1);
 }
 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Button クラス
Button メンバ
System.Windows.Forms 名前空間