Window.DialogResult プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

ダイアログの結果値を取得または設定します。これは、ShowDialog() メソッドから返される値です。

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public bool? DialogResult { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))>]
member this.DialogResult : Nullable<bool> with get, set

Public Property DialogResult As Nullable(Of Boolean)

プロパティ値

Nullable<Boolean>

Boolean型の Nullable<T> 値。 既定値は falseです。

属性

TypeConverterAttribute

例外

InvalidOperationException

DialogResult は、ShowDialog()を呼び出してウィンドウを開く前に設定されます。

-又は-

DialogResult は、Show()を呼び出すことによって開かれたウィンドウに設定されます。

例

次の例は、[OK] ボタンと [キャンセル] ボタンを構成して適切な DialogResultを返す方法を示しています。

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>

using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true.
        // This event is raised whenever this button is clicked, or the ENTER key
        // is pressed.
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result
            this.DialogResult = true;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls

Namespace VisualBasic
    Partial Public Class DialogBox
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        ' The accept button is a button whose IsDefault property is set to true.
        ' This event is raised whenever this button is clicked, or the ENTER key
        ' is pressed.
        Private Sub acceptButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Accept the dialog and return the dialog result
            Me.DialogResult = True
        End Sub
    End Class
End Namespace

注釈

DialogResult は、ダイアログ ボックスを表示したコードから、ユーザーがダイアログ ボックスを受け入れた (true) か取り消された (false) かを判断するために使用できます。 ダイアログ ボックスが受け入れられた場合は、ユーザーによって収集されたデータを取得して処理するためにダイアログ ボックスを開いたコードを示します。 ただし、ダイアログ ボックスが取り消された場合は、呼び出し元のコードがそれ以上の処理を停止する必要があることを示します。

既定では、ユーザーが次のいずれかの操作を行うと、ダイアログ ボックスが取り消されます。

• Alt キーを押しながら F4 キーを押します。

• [閉じる] ボタンをクリックします。

• [システム] メニュー [ を閉じる] を選択します。

いずれの場合も、DialogResult は既定で false。

ダイアログ ボックスには、通常、ダイアログを取り消す特別なボタンが用意されています。これは、IsCancel プロパティが trueに設定されているボタンです。 この方法で構成されたボタンは、ウィンドウが押されたとき、または ESC キーが押されたときに自動的に閉じます。 いずれの場合も、DialogResult は falseのままです。

ダイアログ ボックスには、通常、IsDefault プロパティが trueに設定されているボタンである accept ボタンも用意されています。 この方法で構成されたボタンは、enter キーを押すと、Click イベントを発生させます。 ただし、ダイアログ ボックスは自動的に閉じられません。また、DialogResult を trueに設定することもありません。 このコードは、通常は既定のボタンの Click イベント ハンドラーから手動で記述する必要があります。

DialogResult は、ダイアログ ボックスが表示されていても、受け入れも取り消もしない場合に null されます。

ダイアログ ボックスが閉じた後は、ShowDialog メソッドによって返された値から、または DialogResult プロパティを調べることによって、ダイアログの結果を取得できます。

DialogResult は、ShowDialog メソッドを呼び出すことによって Window が開かれたときにのみ設定できます。

手記

ウィンドウがブラウザーでホストされている場合、このプロパティを設定または取得することはできません。