Window.DialogResult Window.DialogResult Window.DialogResult Window.DialogResult Property

定義

返される値は、ダイアログの結果の値を取得または、ShowDialog()メソッド。Gets or sets the dialog result value, which is the value that is returned from the ShowDialog() method.

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }
member this.DialogResult : Nullable<bool> with get, set
Public Property DialogResult As Nullable(Of Boolean)

プロパティ値

ANullable<T>型の値Booleanします。A Nullable<T> value of type Boolean. 既定値は false です。The default is false.

例外

DialogResult 呼び出すことによって、ウィンドウが開かれる前に設定されてShowDialog()します。DialogResult is set before a window is opened by calling ShowDialog().

- または --or- DialogResult 呼び出すことによって開いたウィンドウで設定されてShow()します。DialogResult is set on a window that is opened by calling Show().

次の例は、[ok] ボタンと [キャンセル] ボタンを返す適切なを構成する方法を示しますDialogResultします。The following example shows how to configure an OK button and a Cancel button to return the appropriate 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
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) ダイアログ ボックス。DialogResult can be used from the code that showed a dialog box to determine whether a user accepted (true) or canceled (false) the dialog box. ダイアログ ボックスが承認された場合、ユーザーによって収集されたデータを取得し、それを処理するには、ダイアログ ボックスを開いたコードにこのことを示します。If a dialog box was accepted, this signifies to the code that opened the dialog box to retrieve the data that was collected by the user and process it. ダイアログ ボックスが取り消された場合、このことを示しますコードの呼び出しを停止する追加の処理します。If a dialog box was canceled, however, this signifies that calling code should stop any further processing.

既定では、ユーザーが、次のいずれかと、ダイアログ ボックスが取り消されました。By default, a dialog box is canceled when a user does one of the following:

  • PressesALT + f4 キー。PressesALT+F4.

  • クリックする、閉じるボタンをクリックします。Clicks the Close button.

  • 選択閉じるシステム メニュー。Selects Close from the System menu.

このような場合は、のすべてのDialogResultfalse既定。In all of these cases, DialogResult is false by default.

ダイアログ ボックスは、通常、ボタンは、ダイアログ ボックスをキャンセルする特殊なボタンを提供します。 あるIsCancelプロパティに設定されてtrueします。A dialog box typically provides a special button to cancel a dialog, which is the button whose IsCancel property is set to true. このように構成されているボタンが押されたか、または ESC キーが押されたときに、ウィンドウは自動的に閉じます。A button configured this way will automatically close a window when either it is pressed, or when the ESC key is pressed. このような場合は、のいずれかでDialogResultままfalseします。In either of these cases, DialogResult remains false.

ダイアログ ボックスも通常は、承認ボタンを提供します。 あるIsDefaultプロパティに設定されてtrueします。A dialog box also typically provides an accept button, which is the button whose IsDefault property is set to true. このように構成されているボタンを発生させる、Clickか、ENTER キーが押されたときにイベント。A button configured this way will raise its Click event when either it or the ENTER key is pressed. ただし、ダイアログ ボックスで、自動的に閉じますも設定はDialogResulttrueします。However, it won't automatically close the dialog box, nor will it set DialogResult to true. このコードをから通常は手動で作成する必要がある、Click既定のボタンのイベント ハンドラー。You need to manually write this code, usually from the Click event handler for the default button.

DialogResult null ダイアログ ボックスが表示されている場合、許容されるも取り消されました。DialogResult is null when the dialog box is shown but neither accepted nor canceled.

ダイアログ ボックスを閉じた後は、によって返される値からダイアログの結果を取得できますShowDialogメソッド、またはを調べることによって、DialogResultプロパティ。After a dialog box closes, you can get the dialog result from the value returned by ShowDialog method, or by inspecting the DialogResult property.

DialogResult のみ設定できる場合に、Windowが呼び出すことによって開かれたそのShowDialogメソッド。DialogResult can only be set when a Window is opened by calling its ShowDialog method.

注意

設定またはウィンドウが、ブラウザーでホストされている場合は、このプロパティを取得することはできません。You cannot set or get this property when a window is hosted in a browser.

適用対象