Window.DialogResult Özellik

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

ShowDialog() yönteminden döndürülen değer olan iletişim kutusu sonuç değerini alır veya ayarlar.

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)

Özellik Değeri

Nullable<Boolean>

Booleantüründe bir Nullable<T> değeri. Varsayılan değer false.

Öznitelikler

TypeConverterAttribute

Özel durumlar

InvalidOperationException

DialogResult, ShowDialog()çağrılarak bir pencere açılmadan önce ayarlanır.

-veya-

DialogResult, Show()çağrılarak açılan bir pencerede ayarlanır.

Örnekler

Aşağıdaki örnekte, uygun DialogResultdöndürmek için Bir Tamam düğmesinin ve İptal düğmesinin nasıl yapılandırılır gösterilmektedir.

<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

Açıklamalar

DialogResult, kullanıcının iletişim kutusunu kabul edip etmediğini (true) veya iptal edip etmediğini (false) belirlemek için bir iletişim kutusu gösteren koddan kullanılabilir. Bir iletişim kutusu kabul edildiyse, bu, kullanıcı tarafından toplanan verileri almak ve işlemek için iletişim kutusunu açan koda işaret eder. Ancak bir iletişim kutusu iptal edildiyse, bu durum kodu çağırmanın daha fazla işlemeyi durdurması gerektiğini gösterir.

Varsayılan olarak, kullanıcı aşağıdakilerden birini yaptığı zaman bir iletişim kutusu iptal edilir:

• ALT+F4 tuşlarına basar.

• Kapat düğmesine tıklar.

• Sistem menüsünden Kapat'ı seçer.

Tüm bu durumlarda DialogResult varsayılan olarak false.

İletişim kutusu genellikle, IsCancel özelliği trueolarak ayarlanmış olan bir iletişim kutusunu iptal etmek için özel bir düğme sağlar. Bu şekilde yapılandırılan bir düğme, bir pencereye basıldığında veya ESC tuşuna basıldığında otomatik olarak kapatılır. Bu iki durumda da DialogResultfalsekalır.

İletişim kutusu genellikle IsDefault özelliği trueolarak ayarlanmış olan bir kabul et düğmesi de sağlar. Bu şekilde yapılandırılan bir düğme, Click olayına veya ENTER tuşuna basıldığında tetiklenir. Ancak, iletişim kutusunu otomatik olarak kapatmaz ve DialogResulttrueolarak ayarlamaz. Bu kodu, genellikle varsayılan düğmenin Click olay işleyicisinden el ile yazmanız gerekir.

DialogResult, iletişim kutusu gösterildiğinde ancak kabul edilmediğinde veya iptal edilmediğinde null.

İletişim kutusu kapatıldıktan sonra, ShowDialog yöntemi tarafından döndürülen değerden veya DialogResult özelliğini inceleyerek iletişim kutusu sonucunu alabilirsiniz.

DialogResult yalnızca ShowDialog yöntemi çağrılarak bir Window açıldığında ayarlanabilir.

Not

Tarayıcıda bir pencere barındırıldığında bu özelliği ayarlayamaz veya alamazsınız.